home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 2000 February / Macworld (2000-02).dmg / Updaters / WhiteCap 3.2.2.sea / WhiteCap 3.2.2 / WhiteCap Source / DirectX3 SDK / inc / ddraw.h < prev    next >
Text File  |  1996-08-28  |  107KB  |  3,103 lines
  1. /*==========================================================================;
  2.  *
  3.  *  Copyright (C) 1994-1996 Microsoft Corporation.  All Rights Reserved.
  4.  *
  5.  *  File:       ddraw.h
  6.  *  Content:    DirectDraw include file
  7.  *
  8.  ***************************************************************************/
  9.  
  10. #ifndef __DDRAW_INCLUDED__
  11. #define __DDRAW_INCLUDED__
  12. #if defined( _WIN32 )  && !defined( _NO_COM )
  13. #define COM_NO_WINDOWS_H
  14. #include <objbase.h>
  15. #else
  16. #define IUnknown            void
  17. #define CO_E_NOTINITIALIZED 0x800401F0L
  18. #endif
  19.  
  20. #define _FACDD  0x876
  21. #define MAKE_DDHRESULT( code )  MAKE_HRESULT( 1, _FACDD, code )
  22.  
  23. #ifdef __cplusplus
  24. extern "C" {
  25. #endif
  26.  
  27. /*
  28.  * GUIDS used by DirectDraw objects
  29.  */
  30. #if defined( _WIN32 ) && !defined( _NO_COM )
  31. DEFINE_GUID( CLSID_DirectDraw,                  0xD7B70EE0,0x4340,0x11CF,0xB0,0x63,0x00,0x20,0xAF,0xC2,0xCD,0x35 );
  32. DEFINE_GUID( CLSID_DirectDrawClipper,           0x593817A0,0x7DB3,0x11CF,0xA2,0xDE,0x00,0xAA,0x00,0xb9,0x33,0x56 );
  33. DEFINE_GUID( IID_IDirectDraw,                   0x6C14DB80,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
  34. DEFINE_GUID( IID_IDirectDraw2,                  0xB3A6F3E0,0x2B43,0x11CF,0xA2,0xDE,0x00,0xAA,0x00,0xB9,0x33,0x56 );
  35. DEFINE_GUID( IID_IDirectDrawSurface,            0x6C14DB81,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
  36. DEFINE_GUID( IID_IDirectDrawSurface2,           0x57805885,0x6eec,0x11cf,0x94,0x41,0xa8,0x23,0x03,0xc1,0x0e,0x27 );
  37.  
  38. DEFINE_GUID( IID_IDirectDrawPalette,            0x6C14DB84,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
  39. DEFINE_GUID( IID_IDirectDrawClipper,            0x6C14DB85,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
  40.                  
  41. #endif
  42.  
  43. /*============================================================================
  44.  *
  45.  * DirectDraw Structures
  46.  *
  47.  * Various structures used to invoke DirectDraw.
  48.  *
  49.  *==========================================================================*/
  50.  
  51. struct IDirectDraw;
  52. struct IDirectDrawSurface;
  53. struct IDirectDrawPalette;
  54. struct IDirectDrawClipper;
  55.  
  56. typedef struct IDirectDraw                      FAR *LPDIRECTDRAW;
  57. typedef struct IDirectDraw2                     FAR *LPDIRECTDRAW2;
  58. typedef struct IDirectDrawSurface               FAR *LPDIRECTDRAWSURFACE;
  59. typedef struct IDirectDrawSurface2              FAR *LPDIRECTDRAWSURFACE2;
  60.  
  61. typedef struct IDirectDrawPalette               FAR *LPDIRECTDRAWPALETTE;
  62. typedef struct IDirectDrawClipper               FAR *LPDIRECTDRAWCLIPPER;
  63.  
  64. typedef struct _DDFXROP                 FAR *LPDDFXROP;
  65. typedef struct _DDSURFACEDESC           FAR *LPDDSURFACEDESC;
  66.  
  67. /*
  68.  * API's
  69.  */
  70. #if (defined (WIN32) || defined( _WIN32 ) ) && !defined( _NO_COM )
  71. //#if defined( _WIN32 ) && !defined( _NO_ENUM )
  72.     typedef BOOL (FAR PASCAL * LPDDENUMCALLBACKA)(GUID FAR *, LPSTR, LPSTR, LPVOID);
  73.     typedef BOOL (FAR PASCAL * LPDDENUMCALLBACKW)(GUID FAR *, LPWSTR, LPWSTR, LPVOID);
  74.     extern HRESULT WINAPI DirectDrawEnumerateW( LPDDENUMCALLBACKW lpCallback, LPVOID lpContext );
  75.     extern HRESULT WINAPI DirectDrawEnumerateA( LPDDENUMCALLBACKA lpCallback, LPVOID lpContext );
  76.     #ifdef UNICODE
  77.         typedef LPDDENUMCALLBACKW       LPDDENUMCALLBACK;
  78.         #define DirectDrawEnumerate     DirectDrawEnumerateW
  79.     #else
  80.         typedef LPDDENUMCALLBACKA       LPDDENUMCALLBACK;
  81.         #define DirectDrawEnumerate     DirectDrawEnumerateA
  82.     #endif
  83.     extern HRESULT WINAPI DirectDrawCreate( GUID FAR *lpGUID, LPDIRECTDRAW FAR *lplpDD, IUnknown FAR *pUnkOuter );
  84.     extern HRESULT WINAPI DirectDrawCreateClipper( DWORD dwFlags, LPDIRECTDRAWCLIPPER FAR *lplpDDClipper, IUnknown FAR *pUnkOuter );
  85.     #ifdef WINNT
  86.         //This is the user-mode entry stub to the kernel mode procedure.
  87.         extern HRESULT NtDirectDrawCreate( GUID FAR *lpGUID, HANDLE *lplpDD, IUnknown FAR *pUnkOuter );
  88.     #endif
  89. #endif
  90.  
  91. #define REGSTR_KEY_DDHW_DESCRIPTION     "Description"
  92. #define REGSTR_KEY_DDHW_DRIVERNAME      "DriverName"
  93. #define REGSTR_PATH_DDHW                "Hardware\\DirectDrawDrivers"
  94.  
  95. #define DDCREATE_HARDWAREONLY           0x00000001l
  96. #define DDCREATE_EMULATIONONLY          0x00000002l
  97.  
  98. #ifdef WINNT
  99. typedef long HRESULT;
  100. #endif
  101.  
  102. //#ifndef WINNT
  103. typedef HRESULT (FAR PASCAL * LPDDENUMMODESCALLBACK)(LPDDSURFACEDESC, LPVOID);
  104. typedef HRESULT (FAR PASCAL * LPDDENUMSURFACESCALLBACK)(LPDIRECTDRAWSURFACE, LPDDSURFACEDESC, LPVOID);
  105. //#endif
  106. /*
  107.  * DDCOLORKEY
  108.  */
  109. typedef struct _DDCOLORKEY
  110. {
  111.     DWORD       dwColorSpaceLowValue;   // low boundary of color space that is to 
  112.                                         // be treated as Color Key, inclusive
  113.     DWORD       dwColorSpaceHighValue;  // high boundary of color space that is 
  114.                                         // to be treated as Color Key, inclusive
  115. } DDCOLORKEY;
  116.  
  117. typedef DDCOLORKEY FAR* LPDDCOLORKEY;
  118.  
  119. /*
  120.  * DDBLTFX
  121.  * Used to pass override information to the DIRECTDRAWSURFACE callback Blt.
  122.  */
  123. typedef struct _DDBLTFX
  124. {
  125.     DWORD       dwSize;                         // size of structure
  126.     DWORD       dwDDFX;                         // FX operations
  127.     DWORD       dwROP;                          // Win32 raster operations
  128.     DWORD       dwDDROP;                        // Raster operations new for DirectDraw
  129.     DWORD       dwRotationAngle;                // Rotation angle for blt
  130.     DWORD       dwZBufferOpCode;                // ZBuffer compares
  131.     DWORD       dwZBufferLow;                   // Low limit of Z buffer
  132.     DWORD       dwZBufferHigh;                  // High limit of Z buffer
  133.     DWORD       dwZBufferBaseDest;              // Destination base value
  134.     DWORD       dwZDestConstBitDepth;           // Bit depth used to specify Z constant for destination
  135.     union
  136.     {
  137.         DWORD   dwZDestConst;                   // Constant to use as Z buffer for dest
  138.         LPDIRECTDRAWSURFACE lpDDSZBufferDest;   // Surface to use as Z buffer for dest
  139.     };
  140.     DWORD       dwZSrcConstBitDepth;            // Bit depth used to specify Z constant for source
  141.     union
  142.     {
  143.         DWORD   dwZSrcConst;                    // Constant to use as Z buffer for src
  144.         LPDIRECTDRAWSURFACE lpDDSZBufferSrc;    // Surface to use as Z buffer for src
  145.     };
  146.     DWORD       dwAlphaEdgeBlendBitDepth;       // Bit depth used to specify constant for alpha edge blend
  147.     DWORD       dwAlphaEdgeBlend;               // Alpha for edge blending
  148.     DWORD       dwReserved;
  149.     DWORD       dwAlphaDestConstBitDepth;       // Bit depth used to specify alpha constant for destination
  150.     union
  151.     {
  152.         DWORD   dwAlphaDestConst;               // Constant to use as Alpha Channel
  153.         LPDIRECTDRAWSURFACE lpDDSAlphaDest;     // Surface to use as Alpha Channel
  154.     };
  155.     DWORD       dwAlphaSrcConstBitDepth;        // Bit depth used to specify alpha constant for source
  156.     union
  157.     {
  158.         DWORD   dwAlphaSrcConst;                // Constant to use as Alpha Channel
  159.         LPDIRECTDRAWSURFACE lpDDSAlphaSrc;      // Surface to use as Alpha Channel
  160.     };
  161.     union
  162.     {
  163.         DWORD   dwFillColor;                    // color in RGB or Palettized
  164.         DWORD   dwFillDepth;                    // depth value for z-buffer
  165.         LPDIRECTDRAWSURFACE lpDDSPattern;       // Surface to use as pattern
  166.     };
  167.     DDCOLORKEY  ddckDestColorkey;               // DestColorkey override
  168.     DDCOLORKEY  ddckSrcColorkey;                // SrcColorkey override
  169. } DDBLTFX;
  170.  
  171. typedef DDBLTFX FAR* LPDDBLTFX;
  172.  
  173.  
  174. /*
  175.  * DDSCAPS
  176.  */
  177. typedef struct _DDSCAPS
  178. {
  179.     DWORD       dwCaps;         // capabilities of surface wanted
  180. } DDSCAPS;
  181.  
  182. typedef DDSCAPS FAR* LPDDSCAPS; 
  183.  
  184. /*
  185.  * DDCAPS
  186.  */
  187. #define DD_ROP_SPACE            (256/32)        // space required to store ROP array
  188.  
  189. typedef struct _DDCAPS
  190. {
  191.     DWORD       dwSize;                 // size of the DDDRIVERCAPS structure
  192.     DWORD       dwCaps;                 // driver specific capabilities
  193.     DWORD       dwCaps2;                // more driver specific capabilites
  194.     DWORD       dwCKeyCaps;             // color key capabilities of the surface
  195.     DWORD       dwFXCaps;               // driver specific stretching and effects capabilites
  196.     DWORD       dwFXAlphaCaps;          // alpha driver specific capabilities
  197.     DWORD       dwPalCaps;              // palette capabilities
  198.     DWORD       dwSVCaps;               // stereo vision capabilities
  199.     DWORD       dwAlphaBltConstBitDepths;       // DDBD_2,4,8
  200.     DWORD       dwAlphaBltPixelBitDepths;       // DDBD_1,2,4,8
  201.     DWORD       dwAlphaBltSurfaceBitDepths;     // DDBD_1,2,4,8
  202.     DWORD       dwAlphaOverlayConstBitDepths;   // DDBD_2,4,8
  203.     DWORD       dwAlphaOverlayPixelBitDepths;   // DDBD_1,2,4,8
  204.     DWORD       dwAlphaOverlaySurfaceBitDepths; // DDBD_1,2,4,8
  205.     DWORD       dwZBufferBitDepths;             // DDBD_8,16,24,32
  206.     DWORD       dwVidMemTotal;          // total amount of video memory
  207.     DWORD       dwVidMemFree;           // amount of free video memory
  208.     DWORD       dwMaxVisibleOverlays;   // maximum number of visible overlays
  209.     DWORD       dwCurrVisibleOverlays;  // current number of visible overlays
  210.     DWORD       dwNumFourCCCodes;       // number of four cc codes
  211.     DWORD       dwAlignBoundarySrc;     // source rectangle alignment
  212.     DWORD       dwAlignSizeSrc;         // source rectangle byte size
  213.     DWORD       dwAlignBoundaryDest;    // dest rectangle alignment
  214.     DWORD       dwAlignSizeDest;        // dest rectangle byte size
  215.     DWORD       dwAlignStrideAlign;     // stride alignment
  216.     DWORD       dwRops[DD_ROP_SPACE];   // ROPS supported
  217.     DDSCAPS     ddsCaps;                // DDSCAPS structure has all the general capabilities
  218.     DWORD       dwMinOverlayStretch;    // minimum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  219.     DWORD       dwMaxOverlayStretch;    // maximum overlay stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  220.     DWORD       dwMinLiveVideoStretch;  // minimum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  221.     DWORD       dwMaxLiveVideoStretch;  // maximum live video stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  222.     DWORD       dwMinHwCodecStretch;    // minimum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  223.     DWORD       dwMaxHwCodecStretch;    // maximum hardware codec stretch factor multiplied by 1000, eg 1000 == 1.0, 1300 == 1.3
  224.     DWORD       dwReserved1;            // reserved
  225.     DWORD       dwReserved2;            // reserved
  226.     DWORD       dwReserved3;            // reserved
  227.     DWORD       dwSVBCaps;              // driver specific capabilities for System->Vmem blts
  228.     DWORD       dwSVBCKeyCaps;          // driver color key capabilities for System->Vmem blts
  229.     DWORD       dwSVBFXCaps;            // driver FX capabilities for System->Vmem blts
  230.     DWORD       dwSVBRops[DD_ROP_SPACE];// ROPS supported for System->Vmem blts
  231.     DWORD       dwVSBCaps;              // driver specific capabilities for Vmem->System blts
  232.     DWORD       dwVSBCKeyCaps;          // driver color key capabilities for Vmem->System blts
  233.     DWORD       dwVSBFXCaps;            // driver FX capabilities for Vmem->System blts
  234.     DWORD       dwVSBRops[DD_ROP_SPACE];// ROPS supported for Vmem->System blts
  235.     DWORD       dwSSBCaps;              // driver specific capabilities for System->System blts
  236.     DWORD       dwSSBCKeyCaps;          // driver color key capabilities for System->System blts
  237.     DWORD       dwSSBFXCaps;            // driver FX capabilities for System->System blts
  238.     DWORD       dwSSBRops[DD_ROP_SPACE];// ROPS supported for System->System blts
  239.     DWORD       dwReserved4;            // reserved
  240.     DWORD       dwReserved5;            // reserved
  241.     DWORD       dwReserved6;            // reserved
  242. } DDCAPS;
  243.  
  244. typedef DDCAPS FAR* LPDDCAPS;
  245.  
  246.  
  247.  
  248. /*
  249.  * DDPIXELFORMAT
  250.  */
  251. typedef struct _DDPIXELFORMAT
  252. {
  253.     DWORD       dwSize;                 // size of structure
  254.     DWORD       dwFlags;                // pixel format flags
  255.     DWORD       dwFourCC;               // (FOURCC code)
  256.     union
  257.     {
  258.         DWORD   dwRGBBitCount;          // how many bits per pixel
  259.         DWORD   dwYUVBitCount;          // how many bits per pixel
  260.         DWORD   dwZBufferBitDepth;      // how many bits for z buffers
  261.         DWORD   dwAlphaBitDepth;        // how many bits for alpha channels
  262.     };
  263.     union
  264.     {
  265.         DWORD   dwRBitMask;             // mask for red bit
  266.         DWORD   dwYBitMask;             // mask for Y bits
  267.     };
  268.     union
  269.     {
  270.         DWORD   dwGBitMask;             // mask for green bits
  271.         DWORD   dwUBitMask;             // mask for U bits
  272.     };
  273.     union
  274.     {
  275.         DWORD   dwBBitMask;             // mask for blue bits
  276.         DWORD   dwVBitMask;             // mask for V bits
  277.     };
  278.     union
  279.     {
  280.         DWORD   dwRGBAlphaBitMask;      // mask for alpha channel
  281.         DWORD   dwYUVAlphaBitMask;      // mask for alpha channel
  282.     };
  283. } DDPIXELFORMAT;
  284.  
  285. typedef DDPIXELFORMAT FAR* LPDDPIXELFORMAT;
  286.  
  287. /*
  288.  * DDOVERLAYFX
  289.  */
  290. typedef struct _DDOVERLAYFX
  291. {
  292.     DWORD       dwSize;                         // size of structure
  293.     DWORD       dwAlphaEdgeBlendBitDepth;       // Bit depth used to specify constant for alpha edge blend
  294.     DWORD       dwAlphaEdgeBlend;               // Constant to use as alpha for edge blend
  295.     DWORD       dwReserved;
  296.     DWORD       dwAlphaDestConstBitDepth;       // Bit depth used to specify alpha constant for destination
  297.     union
  298.     {
  299.         DWORD   dwAlphaDestConst;               // Constant to use as alpha channel for dest
  300.         LPDIRECTDRAWSURFACE lpDDSAlphaDest;     // Surface to use as alpha channel for dest
  301.     };
  302.     DWORD       dwAlphaSrcConstBitDepth;        // Bit depth used to specify alpha constant for source
  303.     union
  304.     {
  305.         DWORD   dwAlphaSrcConst;                // Constant to use as alpha channel for src
  306.         LPDIRECTDRAWSURFACE lpDDSAlphaSrc;      // Surface to use as alpha channel for src
  307.     };
  308.     DDCOLORKEY  dckDestColorkey;                // DestColorkey override
  309.     DDCOLORKEY  dckSrcColorkey;                 // DestColorkey override
  310.     DWORD       dwDDFX;                         // Overlay FX
  311.     DWORD       dwFlags;                        // flags
  312. } DDOVERLAYFX;
  313.  
  314. typedef DDOVERLAYFX FAR *LPDDOVERLAYFX;
  315.  
  316. /*
  317.  * DDBLTBATCH: BltBatch entry structure
  318.  */
  319. typedef struct _DDBLTBATCH
  320. {
  321.     LPRECT              lprDest;
  322.     LPDIRECTDRAWSURFACE lpDDSSrc;
  323.     LPRECT              lprSrc;
  324.     DWORD               dwFlags;
  325.     LPDDBLTFX           lpDDBltFx;
  326. } DDBLTBATCH;
  327.  
  328. typedef DDBLTBATCH FAR * LPDDBLTBATCH;
  329.  
  330. /*
  331.  * callbacks
  332.  */
  333. typedef DWORD   (FAR PASCAL *LPCLIPPERCALLBACK)(LPDIRECTDRAWCLIPPER lpDDClipper, HWND hWnd, DWORD code, LPVOID lpContext );
  334. #ifdef STREAMING
  335. typedef DWORD   (FAR PASCAL *LPSURFACESTREAMINGCALLBACK)(DWORD);
  336. #endif
  337.  
  338.  
  339. /*
  340.  * INTERACES FOLLOW:
  341.  *      IDirectDraw
  342.  *      IDirectDrawClipper
  343.  *      IDirectDrawPalette
  344.  *      IDirectDrawSurface
  345.  */
  346.  
  347. /*
  348.  * IDirectDraw 
  349.  */
  350. #if defined( _WIN32 ) && !defined( _NO_COM )
  351. #undef INTERFACE
  352. #define INTERFACE IDirectDraw
  353. DECLARE_INTERFACE_( IDirectDraw, IUnknown )
  354. {
  355.     /*** IUnknown methods ***/
  356.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  357.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  358.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  359.     /*** IDirectDraw methods ***/
  360.     STDMETHOD(Compact)(THIS) PURE;
  361.     STDMETHOD(CreateClipper)(THIS_ DWORD, LPDIRECTDRAWCLIPPER FAR*, IUnknown FAR * ) PURE;
  362.     STDMETHOD(CreatePalette)(THIS_ DWORD, LPPALETTEENTRY, LPDIRECTDRAWPALETTE FAR*, IUnknown FAR * ) PURE;
  363.     STDMETHOD(CreateSurface)(THIS_  LPDDSURFACEDESC, LPDIRECTDRAWSURFACE FAR *, IUnknown FAR *) PURE;
  364.     STDMETHOD(DuplicateSurface)( THIS_ LPDIRECTDRAWSURFACE, LPDIRECTDRAWSURFACE FAR * ) PURE;
  365.     STDMETHOD(EnumDisplayModes)( THIS_ DWORD, LPDDSURFACEDESC, LPVOID, LPDDENUMMODESCALLBACK ) PURE;
  366.     STDMETHOD(EnumSurfaces)(THIS_ DWORD, LPDDSURFACEDESC, LPVOID,LPDDENUMSURFACESCALLBACK ) PURE;
  367.     STDMETHOD(FlipToGDISurface)(THIS) PURE;
  368.     STDMETHOD(GetCaps)( THIS_ LPDDCAPS, LPDDCAPS) PURE;
  369.     STDMETHOD(GetDisplayMode)( THIS_ LPDDSURFACEDESC) PURE;
  370.     STDMETHOD(GetFourCCCodes)(THIS_  LPDWORD, LPDWORD ) PURE;
  371.     STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE FAR *) PURE;
  372.     STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD) PURE;
  373.     STDMETHOD(GetScanLine)(THIS_ LPDWORD) PURE;
  374.     STDMETHOD(GetVerticalBlankStatus)(THIS_ LPBOOL ) PURE;
  375.     STDMETHOD(Initialize)(THIS_ GUID FAR *) PURE;
  376.     STDMETHOD(RestoreDisplayMode)(THIS) PURE;
  377.     STDMETHOD(SetCooperativeLevel)(THIS_ HWND, DWORD) PURE;
  378.     STDMETHOD(SetDisplayMode)(THIS_ DWORD, DWORD,DWORD) PURE;
  379.     STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD, HANDLE ) PURE;
  380. };
  381.  
  382. #if !defined(__cplusplus) || defined(CINTERFACE)
  383. #define IDirectDraw_QueryInterface(p, a, b)         (p)->lpVtbl->QueryInterface(p, a, b)
  384. #define IDirectDraw_AddRef(p)                       (p)->lpVtbl->AddRef(p)
  385. #define IDirectDraw_Release(p)                      (p)->lpVtbl->Release(p)
  386. #define IDirectDraw_Compact(p)                      (p)->lpVtbl->Compact(p)
  387. #define IDirectDraw_CreateClipper(p, a, b, c)       (p)->lpVtbl->CreateClipper(p, a, b, c)
  388. #define IDirectDraw_CreatePalette(p, a, b, c, d)    (p)->lpVtbl->CreatePalette(p, a, b, c, d)
  389. #define IDirectDraw_CreateSurface(p, a, b, c)       (p)->lpVtbl->CreateSurface(p, a, b, c)
  390. #define IDirectDraw_DuplicateSurface(p, a, b)       (p)->lpVtbl->DuplicateSurface(p, a, b)
  391. #define IDirectDraw_EnumDisplayModes(p, a, b, c, d) (p)->lpVtbl->EnumDisplayModes(p, a, b, c, d)
  392. #define IDirectDraw_EnumSurfaces(p, a, b, c, d)     (p)->lpVtbl->EnumSurfaces(p, a, b, c, d)
  393. #define IDirectDraw_FlipToGDISurface(p)             (p)->lpVtbl->FlipToGDISurface(p)
  394. #define IDirectDraw_GetCaps(p, a, b)                (p)->lpVtbl->GetCaps(p, a, b)
  395. #define IDirectDraw_GetDisplayMode(p, a)            (p)->lpVtbl->GetDisplayMode(p, a)
  396. #define IDirectDraw_GetFourCCCodes(p, a, b)         (p)->lpVtbl->GetFourCCCodes(p, a, b)
  397. #define IDirectDraw_GetGDISurface(p, a)             (p)->lpVtbl->GetGDISurface(p, a)
  398. #define IDirectDraw_GetMonitorFrequency(p, a)       (p)->lpVtbl->GetMonitorFrequency(p, a)
  399. #define IDirectDraw_GetScanLine(p, a)               (p)->lpVtbl->GetScanLine(p, a)
  400. #define IDirectDraw_GetVerticalBlankStatus(p, a)    (p)->lpVtbl->GetVerticalBlankStatus(p, a)
  401. #define IDirectDraw_Initialize(p, a)                (p)->lpVtbl->Initialize(p, a)
  402. #define IDirectDraw_RestoreDisplayMode(p)           (p)->lpVtbl->RestoreDisplayMode(p)
  403. #define IDirectDraw_SetCooperativeLevel(p, a, b)    (p)->lpVtbl->SetCooperativeLevel(p, a, b)
  404. #define IDirectDraw_SetDisplayMode(p, a, b, c)      (p)->lpVtbl->SetDisplayMode(p, a, b, c)
  405. #define IDirectDraw_WaitForVerticalBlank(p, a, b)   (p)->lpVtbl->WaitForVerticalBlank(p, a, b)
  406. #endif
  407.  
  408. #endif
  409.  
  410. #if defined( _WIN32 ) && !defined( _NO_COM )
  411. #undef INTERFACE
  412. #define INTERFACE IDirectDraw2
  413. DECLARE_INTERFACE_( IDirectDraw2, IUnknown )
  414. {
  415.     /*** IUnknown methods ***/
  416.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  417.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  418.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  419.     /*** IDirectDraw methods ***/
  420.     STDMETHOD(Compact)(THIS) PURE;
  421.     STDMETHOD(CreateClipper)(THIS_ DWORD, LPDIRECTDRAWCLIPPER FAR*, IUnknown FAR * ) PURE;
  422.     STDMETHOD(CreatePalette)(THIS_ DWORD, LPPALETTEENTRY, LPDIRECTDRAWPALETTE FAR*, IUnknown FAR * ) PURE;
  423.     STDMETHOD(CreateSurface)(THIS_  LPDDSURFACEDESC, LPDIRECTDRAWSURFACE FAR *, IUnknown FAR *) PURE;
  424.     STDMETHOD(DuplicateSurface)( THIS_ LPDIRECTDRAWSURFACE, LPDIRECTDRAWSURFACE FAR * ) PURE;
  425.     STDMETHOD(EnumDisplayModes)( THIS_ DWORD, LPDDSURFACEDESC, LPVOID, LPDDENUMMODESCALLBACK ) PURE;
  426.     STDMETHOD(EnumSurfaces)(THIS_ DWORD, LPDDSURFACEDESC, LPVOID,LPDDENUMSURFACESCALLBACK ) PURE;
  427.     STDMETHOD(FlipToGDISurface)(THIS) PURE;
  428.     STDMETHOD(GetCaps)( THIS_ LPDDCAPS, LPDDCAPS) PURE;
  429.     STDMETHOD(GetDisplayMode)( THIS_ LPDDSURFACEDESC) PURE;
  430.     STDMETHOD(GetFourCCCodes)(THIS_  LPDWORD, LPDWORD ) PURE;
  431.     STDMETHOD(GetGDISurface)(THIS_ LPDIRECTDRAWSURFACE FAR *) PURE;
  432.     STDMETHOD(GetMonitorFrequency)(THIS_ LPDWORD) PURE;
  433.     STDMETHOD(GetScanLine)(THIS_ LPDWORD) PURE;
  434.     STDMETHOD(GetVerticalBlankStatus)(THIS_ LPBOOL ) PURE;
  435.     STDMETHOD(Initialize)(THIS_ GUID FAR *) PURE;
  436.     STDMETHOD(RestoreDisplayMode)(THIS) PURE;
  437.     STDMETHOD(SetCooperativeLevel)(THIS_ HWND, DWORD) PURE;
  438.     STDMETHOD(SetDisplayMode)(THIS_ DWORD, DWORD,DWORD, DWORD, DWORD) PURE;
  439.     STDMETHOD(WaitForVerticalBlank)(THIS_ DWORD, HANDLE ) PURE;
  440.     /*** Added in the v2 interface ***/
  441.     STDMETHOD(GetAvailableVidMem)(THIS_ LPDDSCAPS, LPDWORD, LPDWORD) PURE;
  442. };
  443. #if !defined(__cplusplus) || defined(CINTERFACE)
  444. #define IDirectDraw2_QueryInterface(p, a, b)         (p)->lpVtbl->QueryInterface(p, a, b)
  445. #define IDirectDraw2_AddRef(p)                       (p)->lpVtbl->AddRef(p)
  446. #define IDirectDraw2_Release(p)                      (p)->lpVtbl->Release(p)
  447. #define IDirectDraw2_Compact(p)                      (p)->lpVtbl->Compact(p)
  448. #define IDirectDraw2_CreateClipper(p, a, b, c)       (p)->lpVtbl->CreateClipper(p, a, b, c)
  449. #define IDirectDraw2_CreatePalette(p, a, b, c, d)    (p)->lpVtbl->CreatePalette(p, a, b, c, d)
  450. #define IDirectDraw2_CreateSurface(p, a, b, c)       (p)->lpVtbl->CreateSurface(p, a, b, c)
  451. #define IDirectDraw2_DuplicateSurface(p, a, b)       (p)->lpVtbl->DuplicateSurface(p, a, b)
  452. #define IDirectDraw2_EnumDisplayModes(p, a, b, c, d) (p)->lpVtbl->EnumDisplayModes(p, a, b, c, d)
  453. #define IDirectDraw2_EnumSurfaces(p, a, b, c, d)     (p)->lpVtbl->EnumSurfaces(p, a, b, c, d)
  454. #define IDirectDraw2_FlipToGDISurface(p)             (p)->lpVtbl->FlipToGDISurface(p)
  455. #define IDirectDraw2_GetCaps(p, a, b)                (p)->lpVtbl->GetCaps(p, a, b)
  456. #define IDirectDraw2_GetDisplayMode(p, a)            (p)->lpVtbl->GetDisplayMode(p, a)
  457. #define IDirectDraw2_GetFourCCCodes(p, a, b)         (p)->lpVtbl->GetFourCCCodes(p, a, b)
  458. #define IDirectDraw2_GetGDISurface(p, a)             (p)->lpVtbl->GetGDISurface(p, a)
  459. #define IDirectDraw2_GetMonitorFrequency(p, a)       (p)->lpVtbl->GetMonitorFrequency(p, a)
  460. #define IDirectDraw2_GetScanLine(p, a)               (p)->lpVtbl->GetScanLine(p, a)
  461. #define IDirectDraw2_GetVerticalBlankStatus(p, a)    (p)->lpVtbl->GetVerticalBlankStatus(p, a)
  462. #define IDirectDraw2_Initialize(p, a)                (p)->lpVtbl->Initialize(p, a)
  463. #define IDirectDraw2_RestoreDisplayMode(p)           (p)->lpVtbl->RestoreDisplayMode(p)
  464. #define IDirectDraw2_SetCooperativeLevel(p, a, b)    (p)->lpVtbl->SetCooperativeLevel(p, a, b)
  465. #define IDirectDraw2_SetDisplayMode(p, a, b, c, d, e) (p)->lpVtbl->SetDisplayMode(p, a, b, c, d, e)
  466. #define IDirectDraw2_WaitForVerticalBlank(p, a, b)   (p)->lpVtbl->WaitForVerticalBlank(p, a, b)
  467. #define IDirectDraw2_GetAvailableVidMem(p, a, b, c)  (p)->lpVtbl->GetAvailableVidMem(p, a, b, c)
  468. #endif
  469.  
  470. #endif
  471.  
  472. /*
  473.  * IDirectDrawPalette
  474.  */
  475. #if defined( _WIN32 ) && !defined( _NO_COM )
  476. #undef INTERFACE
  477. #define INTERFACE IDirectDrawPalette
  478. DECLARE_INTERFACE_( IDirectDrawPalette, IUnknown )
  479. {
  480.     /*** IUnknown methods ***/
  481.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  482.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  483.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  484.     /*** IDirectDrawPalette methods ***/
  485.     STDMETHOD(GetCaps)(THIS_ LPDWORD) PURE;
  486.     STDMETHOD(GetEntries)(THIS_ DWORD,DWORD,DWORD,LPPALETTEENTRY) PURE;
  487.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, DWORD, LPPALETTEENTRY) PURE;
  488.     STDMETHOD(SetEntries)(THIS_ DWORD,DWORD,DWORD,LPPALETTEENTRY) PURE;
  489. };
  490.  
  491. #if !defined(__cplusplus) || defined(CINTERFACE)
  492. #define IDirectDrawPalette_QueryInterface(p, a, b)      (p)->lpVtbl->QueryInterface(p, a, b)
  493. #define IDirectDrawPalette_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  494. #define IDirectDrawPalette_Release(p)                   (p)->lpVtbl->Release(p)
  495. #define IDirectDrawPalette_GetCaps(p, a)                (p)->lpVtbl->GetCaps(p, a)
  496. #define IDirectDrawPalette_GetEntries(p, a, b, c, d)    (p)->lpVtbl->GetEntries(p, a, b, c, d)
  497. #define IDirectDrawPalette_Initialize(p, a, b, c)       (p)->lpVtbl->Initialize(p, a, b, c)
  498. #define IDirectDrawPalette_SetEntries(p, a, b, c, d)    (p)->lpVtbl->SetEntries(p, a, b, c, d)
  499. #endif
  500.  
  501. #endif
  502.  
  503. /*
  504.  * IDirectDrawClipper
  505.  */
  506. #if defined( _WIN32 ) && !defined( _NO_COM )
  507. #undef INTERFACE
  508. #define INTERFACE IDirectDrawClipper
  509. DECLARE_INTERFACE_( IDirectDrawClipper, IUnknown )
  510. {
  511.     /*** IUnknown methods ***/
  512.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  513.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  514.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  515.     /*** IDirectDrawClipper methods ***/
  516.     STDMETHOD(GetClipList)(THIS_ LPRECT, LPRGNDATA, LPDWORD) PURE;
  517.     STDMETHOD(GetHWnd)(THIS_ HWND FAR *) PURE;
  518.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, DWORD) PURE;
  519.     STDMETHOD(IsClipListChanged)(THIS_ BOOL FAR *) PURE;
  520.     STDMETHOD(SetClipList)(THIS_ LPRGNDATA,DWORD) PURE;
  521.     STDMETHOD(SetHWnd)(THIS_ DWORD, HWND ) PURE;
  522. };
  523.  
  524. #if !defined(__cplusplus) || defined(CINTERFACE)
  525. #define IDirectDrawClipper_QueryInterface(p, a, b)  (p)->lpVtbl->QueryInterface(p, a, b)
  526. #define IDirectDrawClipper_AddRef(p)                (p)->lpVtbl->AddRef(p)
  527. #define IDirectDrawClipper_Release(p)               (p)->lpVtbl->Release(p)
  528. #define IDirectDrawClipper_GetClipList(p, a, b, c)  (p)->lpVtbl->GetClipList(p, a, b, c)
  529. #define IDirectDrawClipper_GetHWnd(p, a)            (p)->lpVtbl->GetHWnd(p, a)
  530. #define IDirectDrawClipper_Initialize(p, a, b)      (p)->lpVtbl->Initialize(p, a, b)
  531. #define IDirectDrawClipper_IsClipListChanged(p, a)  (p)->lpVtbl->IsClipListChanged(p, a)
  532. #define IDirectDrawClipper_SetClipList(p, a, b)     (p)->lpVtbl->SetClipList(p, a, b)
  533. #define IDirectDrawClipper_SetHWnd(p, a, b)         (p)->lpVtbl->SetHWnd(p, a, b)
  534. #endif
  535.  
  536. #endif
  537.  
  538. /*
  539.  * IDirectDrawSurface and related interfaces
  540.  */
  541. #if defined( _WIN32 ) && !defined( _NO_COM )
  542. #undef INTERFACE
  543. #define INTERFACE IDirectDrawSurface
  544. DECLARE_INTERFACE_( IDirectDrawSurface, IUnknown )
  545. {
  546.     /*** IUnknown methods ***/
  547.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  548.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  549.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  550.     /*** IDirectDrawSurface methods ***/
  551.     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE) PURE;
  552.     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT) PURE;
  553.     STDMETHOD(Blt)(THIS_ LPRECT,LPDIRECTDRAWSURFACE, LPRECT,DWORD, LPDDBLTFX) PURE;
  554.     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH, DWORD, DWORD ) PURE;
  555.     STDMETHOD(BltFast)(THIS_ DWORD,DWORD,LPDIRECTDRAWSURFACE, LPRECT,DWORD) PURE;
  556.     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD,LPDIRECTDRAWSURFACE) PURE;
  557.     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
  558.     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD,LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
  559.     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE, DWORD) PURE;
  560.     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS, LPDIRECTDRAWSURFACE FAR *) PURE;
  561.     STDMETHOD(GetBltStatus)(THIS_ DWORD) PURE;
  562.     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS) PURE;
  563.     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER FAR*) PURE;
  564.     STDMETHOD(GetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  565.     STDMETHOD(GetDC)(THIS_ HDC FAR *) PURE;
  566.     STDMETHOD(GetFlipStatus)(THIS_ DWORD) PURE;
  567.     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG, LPLONG ) PURE;
  568.     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE FAR*) PURE;
  569.     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT) PURE;
  570.     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC) PURE;
  571.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, LPDDSURFACEDESC) PURE;
  572.     STDMETHOD(IsLost)(THIS) PURE;
  573.     STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC,DWORD,HANDLE) PURE;
  574.     STDMETHOD(ReleaseDC)(THIS_ HDC) PURE;
  575.     STDMETHOD(Restore)(THIS) PURE;
  576.     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER) PURE;
  577.     STDMETHOD(SetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  578.     STDMETHOD(SetOverlayPosition)(THIS_ LONG, LONG ) PURE;
  579.     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE) PURE;
  580.     STDMETHOD(Unlock)(THIS_ LPVOID) PURE;
  581.     STDMETHOD(UpdateOverlay)(THIS_ LPRECT, LPDIRECTDRAWSURFACE,LPRECT,DWORD, LPDDOVERLAYFX) PURE;
  582.     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD) PURE;
  583.     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD, LPDIRECTDRAWSURFACE) PURE;
  584. };
  585.  
  586. #if !defined(__cplusplus) || defined(CINTERFACE)
  587. #define IDirectDrawSurface_QueryInterface(p,a,b)        (p)->lpVtbl->QueryInterface(p,a,b)
  588. #define IDirectDrawSurface_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  589. #define IDirectDrawSurface_Release(p)                   (p)->lpVtbl->Release(p)
  590. #define IDirectDrawSurface_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
  591. #define IDirectDrawSurface_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
  592. #define IDirectDrawSurface_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
  593. #define IDirectDrawSurface_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
  594. #define IDirectDrawSurface_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
  595. #define IDirectDrawSurface_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
  596. #define IDirectDrawSurface_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
  597. #define IDirectDrawSurface_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
  598. #define IDirectDrawSurface_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
  599. #define IDirectDrawSurface_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
  600. #define IDirectDrawSurface_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
  601. #define IDirectDrawSurface_GetCaps(p,b)                 (p)->lpVtbl->GetCaps(p,b)
  602. #define IDirectDrawSurface_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
  603. #define IDirectDrawSurface_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
  604. #define IDirectDrawSurface_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
  605. #define IDirectDrawSurface_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
  606. #define IDirectDrawSurface_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
  607. #define IDirectDrawSurface_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
  608. #define IDirectDrawSurface_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
  609. #define IDirectDrawSurface_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
  610. #define IDirectDrawSurface_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
  611. #define IDirectDrawSurface_IsLost(p)                    (p)->lpVtbl->IsLost(p)
  612. #define IDirectDrawSurface_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
  613. #define IDirectDrawSurface_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
  614. #define IDirectDrawSurface_Restore(p)                   (p)->lpVtbl->Restore(p)
  615. #define IDirectDrawSurface_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
  616. #define IDirectDrawSurface_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
  617. #define IDirectDrawSurface_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
  618. #define IDirectDrawSurface_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
  619. #define IDirectDrawSurface_Unlock(p,b)                  (p)->lpVtbl->Unlock(p,b)
  620. #define IDirectDrawSurface_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
  621. #define IDirectDrawSurface_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
  622. #define IDirectDrawSurface_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
  623. #endif
  624.  
  625. /*
  626.  * IDirectDrawSurface2 and related interfaces
  627.  */
  628. #undef INTERFACE
  629. #define INTERFACE IDirectDrawSurface2
  630. DECLARE_INTERFACE_( IDirectDrawSurface2, IUnknown )
  631. {
  632.     /*** IUnknown methods ***/
  633.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
  634.     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
  635.     STDMETHOD_(ULONG,Release) (THIS) PURE;
  636.     /*** IDirectDrawSurface methods ***/
  637.     STDMETHOD(AddAttachedSurface)(THIS_ LPDIRECTDRAWSURFACE2) PURE;
  638.     STDMETHOD(AddOverlayDirtyRect)(THIS_ LPRECT) PURE;
  639.     STDMETHOD(Blt)(THIS_ LPRECT,LPDIRECTDRAWSURFACE2, LPRECT,DWORD, LPDDBLTFX) PURE;
  640.     STDMETHOD(BltBatch)(THIS_ LPDDBLTBATCH, DWORD, DWORD ) PURE;
  641.     STDMETHOD(BltFast)(THIS_ DWORD,DWORD,LPDIRECTDRAWSURFACE2, LPRECT,DWORD) PURE;
  642.     STDMETHOD(DeleteAttachedSurface)(THIS_ DWORD,LPDIRECTDRAWSURFACE2) PURE;
  643.     STDMETHOD(EnumAttachedSurfaces)(THIS_ LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
  644.     STDMETHOD(EnumOverlayZOrders)(THIS_ DWORD,LPVOID,LPDDENUMSURFACESCALLBACK) PURE;
  645.     STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE2, DWORD) PURE;
  646.     STDMETHOD(GetAttachedSurface)(THIS_ LPDDSCAPS, LPDIRECTDRAWSURFACE2 FAR *) PURE;
  647.     STDMETHOD(GetBltStatus)(THIS_ DWORD) PURE;
  648.     STDMETHOD(GetCaps)(THIS_ LPDDSCAPS) PURE;
  649.     STDMETHOD(GetClipper)(THIS_ LPDIRECTDRAWCLIPPER FAR*) PURE;
  650.     STDMETHOD(GetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  651.     STDMETHOD(GetDC)(THIS_ HDC FAR *) PURE;
  652.     STDMETHOD(GetFlipStatus)(THIS_ DWORD) PURE;
  653.     STDMETHOD(GetOverlayPosition)(THIS_ LPLONG, LPLONG ) PURE;
  654.     STDMETHOD(GetPalette)(THIS_ LPDIRECTDRAWPALETTE FAR*) PURE;
  655.     STDMETHOD(GetPixelFormat)(THIS_ LPDDPIXELFORMAT) PURE;
  656.     STDMETHOD(GetSurfaceDesc)(THIS_ LPDDSURFACEDESC) PURE;
  657.     STDMETHOD(Initialize)(THIS_ LPDIRECTDRAW, LPDDSURFACEDESC) PURE;
  658.     STDMETHOD(IsLost)(THIS) PURE;
  659.     STDMETHOD(Lock)(THIS_ LPRECT,LPDDSURFACEDESC,DWORD,HANDLE) PURE;
  660.     STDMETHOD(ReleaseDC)(THIS_ HDC) PURE;
  661.     STDMETHOD(Restore)(THIS) PURE;
  662.     STDMETHOD(SetClipper)(THIS_ LPDIRECTDRAWCLIPPER) PURE;
  663.     STDMETHOD(SetColorKey)(THIS_ DWORD, LPDDCOLORKEY) PURE;
  664.     STDMETHOD(SetOverlayPosition)(THIS_ LONG, LONG ) PURE;
  665.     STDMETHOD(SetPalette)(THIS_ LPDIRECTDRAWPALETTE) PURE;
  666.     STDMETHOD(Unlock)(THIS_ LPVOID) PURE;
  667.     STDMETHOD(UpdateOverlay)(THIS_ LPRECT, LPDIRECTDRAWSURFACE2,LPRECT,DWORD, LPDDOVERLAYFX) PURE;
  668.     STDMETHOD(UpdateOverlayDisplay)(THIS_ DWORD) PURE;
  669.     STDMETHOD(UpdateOverlayZOrder)(THIS_ DWORD, LPDIRECTDRAWSURFACE2) PURE;
  670.     /*** Added in the v2 interface ***/
  671.     STDMETHOD(GetDDInterface)(THIS_ LPVOID FAR *) PURE;
  672.     STDMETHOD(PageLock)(THIS_ DWORD) PURE;
  673.     STDMETHOD(PageUnlock)(THIS_ DWORD) PURE;
  674. };
  675.  
  676. #if !defined(__cplusplus) || defined(CINTERFACE)
  677. #define IDirectDrawSurface2_QueryInterface(p,a,b)        (p)->lpVtbl->QueryInterface(p,a,b)
  678. #define IDirectDrawSurface2_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  679. #define IDirectDrawSurface2_Release(p)                   (p)->lpVtbl->Release(p)
  680. #define IDirectDrawSurface2_AddAttachedSurface(p,a)      (p)->lpVtbl->AddAttachedSurface(p,a)
  681. #define IDirectDrawSurface2_AddOverlayDirtyRect(p,a)     (p)->lpVtbl->AddOverlayDirtyRect(p,a)
  682. #define IDirectDrawSurface2_Blt(p,a,b,c,d,e)             (p)->lpVtbl->Blt(p,a,b,c,d,e)
  683. #define IDirectDrawSurface2_BltBatch(p,a,b,c)            (p)->lpVtbl->BltBatch(p,a,b,c)
  684. #define IDirectDrawSurface2_BltFast(p,a,b,c,d,e)         (p)->lpVtbl->BltFast(p,a,b,c,d,e)
  685. #define IDirectDrawSurface2_DeleteAttachedSurface(p,a,b) (p)->lpVtbl->DeleteAttachedSurface(p,a,b)
  686. #define IDirectDrawSurface2_EnumAttachedSurfaces(p,a,b)  (p)->lpVtbl->EnumAttachedSurfaces(p,a,b)
  687. #define IDirectDrawSurface2_EnumOverlayZOrders(p,a,b,c)  (p)->lpVtbl->EnumOverlayZOrders(p,a,b,c)
  688. #define IDirectDrawSurface2_Flip(p,a,b)                  (p)->lpVtbl->Flip(p,a,b)
  689. #define IDirectDrawSurface2_GetAttachedSurface(p,a,b)    (p)->lpVtbl->GetAttachedSurface(p,a,b)
  690. #define IDirectDrawSurface2_GetBltStatus(p,a)            (p)->lpVtbl->GetBltStatus(p,a)
  691. #define IDirectDrawSurface2_GetCaps(p,b)                 (p)->lpVtbl->GetCaps(p,b)
  692. #define IDirectDrawSurface2_GetClipper(p,a)              (p)->lpVtbl->GetClipper(p,a)
  693. #define IDirectDrawSurface2_GetColorKey(p,a,b)           (p)->lpVtbl->GetColorKey(p,a,b)
  694. #define IDirectDrawSurface2_GetDC(p,a)                   (p)->lpVtbl->GetDC(p,a)
  695. #define IDirectDrawSurface2_GetFlipStatus(p,a)           (p)->lpVtbl->GetFlipStatus(p,a)
  696. #define IDirectDrawSurface2_GetOverlayPosition(p,a,b)    (p)->lpVtbl->GetOverlayPosition(p,a,b)
  697. #define IDirectDrawSurface2_GetPalette(p,a)              (p)->lpVtbl->GetPalette(p,a)
  698. #define IDirectDrawSurface2_GetPixelFormat(p,a)          (p)->lpVtbl->GetPixelFormat(p,a)
  699. #define IDirectDrawSurface2_GetSurfaceDesc(p,a)          (p)->lpVtbl->GetSurfaceDesc(p,a)
  700. #define IDirectDrawSurface2_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
  701. #define IDirectDrawSurface2_IsLost(p)                    (p)->lpVtbl->IsLost(p)
  702. #define IDirectDrawSurface2_Lock(p,a,b,c,d)              (p)->lpVtbl->Lock(p,a,b,c,d)
  703. #define IDirectDrawSurface2_ReleaseDC(p,a)               (p)->lpVtbl->ReleaseDC(p,a)
  704. #define IDirectDrawSurface2_Restore(p)                   (p)->lpVtbl->Restore(p)
  705. #define IDirectDrawSurface2_SetClipper(p,a)              (p)->lpVtbl->SetClipper(p,a)
  706. #define IDirectDrawSurface2_SetColorKey(p,a,b)           (p)->lpVtbl->SetColorKey(p,a,b)
  707. #define IDirectDrawSurface2_SetOverlayPosition(p,a,b)    (p)->lpVtbl->SetOverlayPosition(p,a,b)
  708. #define IDirectDrawSurface2_SetPalette(p,a)              (p)->lpVtbl->SetPalette(p,a)
  709. #define IDirectDrawSurface2_Unlock(p,b)                  (p)->lpVtbl->Unlock(p,b)
  710. #define IDirectDrawSurface2_UpdateOverlay(p,a,b,c,d,e)   (p)->lpVtbl->UpdateOverlay(p,a,b,c,d,e)
  711. #define IDirectDrawSurface2_UpdateOverlayDisplay(p,a)    (p)->lpVtbl->UpdateOverlayDisplay(p,a)
  712. #define IDirectDrawSurface2_UpdateOverlayZOrder(p,a,b)   (p)->lpVtbl->UpdateOverlayZOrder(p,a,b)
  713. #define IDirectDrawSurface2_GetDDInterface(p,a)          (p)->lpVtbl->GetDDInterface(p,a)
  714. #define IDirectDrawSurface2_PageLock(p,a)                (p)->lpVtbl->PageLock(p,a)
  715. #define IDirectDrawSurface2_PageUnlock(p,a)              (p)->lpVtbl->PageUnlock(p,a)
  716. #endif
  717.  
  718.  
  719. #endif
  720.  
  721.  
  722. /*
  723.  * DDSURFACEDESC
  724.  */
  725. typedef struct _DDSURFACEDESC
  726. {
  727.     DWORD               dwSize;                 // size of the DDSURFACEDESC structure
  728.     DWORD               dwFlags;                // determines what fields are valid
  729.     DWORD               dwHeight;               // height of surface to be created
  730.     DWORD               dwWidth;                // width of input surface
  731.     LONG                lPitch;                 // distance to start of next line (return value only)
  732.     DWORD               dwBackBufferCount;      // number of back buffers requested
  733.     union
  734.     {
  735.         DWORD           dwMipMapCount;          // number of mip-map levels requested
  736.         DWORD           dwZBufferBitDepth;      // depth of Z buffer requested
  737.         DWORD           dwRefreshRate;          // refresh rate (used when display mode is described)
  738.     };
  739.     DWORD               dwAlphaBitDepth;        // depth of alpha buffer requested
  740.     DWORD               dwReserved;             // reserved
  741.     LPVOID              lpSurface;              // pointer to the associated surface memory
  742.     DDCOLORKEY          ddckCKDestOverlay;      // color key for destination overlay use
  743.     DDCOLORKEY          ddckCKDestBlt;          // color key for destination blt use
  744.     DDCOLORKEY          ddckCKSrcOverlay;       // color key for source overlay use
  745.     DDCOLORKEY          ddckCKSrcBlt;           // color key for source blt use
  746.     DDPIXELFORMAT       ddpfPixelFormat;        // pixel format description of the surface
  747.     DDSCAPS             ddsCaps;                // direct draw surface capabilities
  748. } DDSURFACEDESC;
  749.  
  750. /*
  751.  * ddsCaps field is valid.
  752.  */
  753. #define DDSD_CAPS               0x00000001l     // default
  754.  
  755. /*
  756.  * dwHeight field is valid.
  757.  */
  758. #define DDSD_HEIGHT             0x00000002l
  759.  
  760. /*
  761.  * dwWidth field is valid.
  762.  */
  763. #define DDSD_WIDTH              0x00000004l
  764.  
  765. /*
  766.  * lPitch is valid.
  767.  */
  768. #define DDSD_PITCH              0x00000008l
  769.  
  770. /*
  771.  * dwBackBufferCount is valid.
  772.  */
  773. #define DDSD_BACKBUFFERCOUNT    0x00000020l
  774.  
  775. /*
  776.  * dwZBufferBitDepth is valid.
  777.  */
  778. #define DDSD_ZBUFFERBITDEPTH    0x00000040l
  779.  
  780. /*
  781.  * dwAlphaBitDepth is valid.
  782.  */
  783. #define DDSD_ALPHABITDEPTH      0x00000080l
  784.  
  785.  
  786.  
  787. /*
  788.  * ddpfPixelFormat is valid.
  789.  */
  790. #define DDSD_PIXELFORMAT        0x00001000l
  791.  
  792. /*
  793.  * ddckCKDestOverlay is valid.
  794.  */
  795. #define DDSD_CKDESTOVERLAY      0x00002000l
  796.  
  797. /*
  798.  * ddckCKDestBlt is valid.
  799.  */
  800. #define DDSD_CKDESTBLT          0x00004000l
  801.  
  802. /*
  803.  * ddckCKSrcOverlay is valid.
  804.  */
  805. #define DDSD_CKSRCOVERLAY       0x00008000l
  806.  
  807. /*
  808.  * ddckCKSrcBlt is valid.
  809.  */
  810. #define DDSD_CKSRCBLT           0x00010000l
  811.  
  812. /*
  813.  * dwMipMapCount is valid.
  814.  */
  815. #define DDSD_MIPMAPCOUNT        0x00020000l
  816.  
  817.  /*
  818.   * dwRefreshRate is valid
  819.   */
  820. #define DDSD_REFRESHRATE        0x00040000l
  821.  
  822.  
  823. /*
  824.  * All input fields are valid. 
  825.  */
  826. #define DDSD_ALL                0x0007f9eel
  827.  
  828.  
  829. /*============================================================================
  830.  *
  831.  * Direct Draw Capability Flags
  832.  *
  833.  * These flags are used to describe the capabilities of a given Surface.
  834.  * All flags are bit flags. 
  835.  *
  836.  *==========================================================================*/
  837.  
  838. /****************************************************************************
  839.  *
  840.  * DIRECTDRAWSURFACE CAPABILITY FLAGS
  841.  *
  842.  ****************************************************************************/
  843. /*
  844.  * This bit currently has no meaning.
  845.  */
  846. #define DDSCAPS_3D                              0x00000001l
  847.  
  848. /*
  849.  * Indicates that this surface contains alpha information.  The pixel
  850.  * format must be interrogated to determine whether this surface
  851.  * contains only alpha information or alpha information interlaced
  852.  * with pixel color data (e.g. RGBA or YUVA).
  853.  */
  854. #define DDSCAPS_ALPHA                           0x00000002l
  855.  
  856. /*
  857.  * Indicates that this surface is a backbuffer.  It is generally
  858.  * set by CreateSurface when the DDSCAPS_FLIP capability bit is set.
  859.  * It indicates that this surface is THE back buffer of a surface
  860.  * flipping structure.  DirectDraw supports N surfaces in a
  861.  * surface flipping structure.  Only the surface that immediately
  862.  * precedeces the DDSCAPS_FRONTBUFFER has this capability bit set.
  863.  * The other surfaces are identified as back buffers by the presence
  864.  * of the DDSCAPS_FLIP capability, their attachment order, and the
  865.  * absence of the DDSCAPS_FRONTBUFFER and DDSCAPS_BACKBUFFER
  866.  * capabilities.  The bit is sent to CreateSurface when a standalone
  867.  * back buffer is being created.  This surface could be attached to
  868.  * a front buffer and/or back buffers to form a flipping surface
  869.  * structure after the CreateSurface call.  See AddAttachments for
  870.  * a detailed description of the behaviors in this case.
  871.  */
  872. #define DDSCAPS_BACKBUFFER                      0x00000004l
  873.  
  874. /*
  875.  * Indicates a complex surface structure is being described.  A
  876.  * complex surface structure results in the creation of more than
  877.  * one surface.  The additional surfaces are attached to the root
  878.  * surface.  The complex structure can only be destroyed by
  879.  * destroying the root.
  880.  */
  881. #define DDSCAPS_COMPLEX                         0x00000008l
  882.  
  883. /*
  884.  * Indicates that this surface is a part of a surface flipping structure.
  885.  * When it is passed to CreateSurface the DDSCAPS_FRONTBUFFER and
  886.  * DDSCAP_BACKBUFFER bits are not set.  They are set by CreateSurface
  887.  * on the resulting creations.  The dwBackBufferCount field in the
  888.  * DDSURFACEDESC structure must be set to at least 1 in order for
  889.  * the CreateSurface call to succeed.  The DDSCAPS_COMPLEX capability
  890.  * must always be set with creating multiple surfaces through CreateSurface.
  891.  */
  892. #define DDSCAPS_FLIP                            0x00000010l
  893.  
  894. /*
  895.  * Indicates that this surface is THE front buffer of a surface flipping
  896.  * structure.  It is generally set by CreateSurface when the DDSCAPS_FLIP
  897.  * capability bit is set.
  898.  * If this capability is sent to CreateSurface then a standalonw front buffer
  899.  * is created.  This surface will not have the DDSCAPS_FLIP capability.
  900.  * It can be attached to other back buffers to form a flipping structure.
  901.  * See AddAttachments for a detailed description of the behaviors in this
  902.  * case.
  903.  */
  904. #define DDSCAPS_FRONTBUFFER                     0x00000020l
  905.  
  906. /*
  907.  * Indicates that this surface is any offscreen surface that is not an overlay,
  908.  * texture, zbuffer, front buffer, back buffer, or alpha surface.  It is used
  909.  * to identify plain vanilla surfaces.
  910.  */
  911. #define DDSCAPS_OFFSCREENPLAIN                  0x00000040l
  912.  
  913. /*
  914.  * Indicates that this surface is an overlay.  It may or may not be directly visible
  915.  * depending on whether or not it is currently being overlayed onto the primary 
  916.  * surface.  DDSCAPS_VISIBLE can be used to determine whether or not it is being 
  917.  * overlayed at the moment. 
  918.  */
  919. #define DDSCAPS_OVERLAY                         0x00000080l
  920.  
  921. /*
  922.  * Indicates that unique DirectDrawPalette objects can be created and
  923.  * attached to this surface.
  924.  */
  925. #define DDSCAPS_PALETTE                         0x00000100l
  926.  
  927. /*
  928.  * Indicates that this surface is the primary surface.  The primary
  929.  * surface represents what the user is seeing at the moment.
  930.  */
  931. #define DDSCAPS_PRIMARYSURFACE                  0x00000200l
  932.  
  933. /*
  934.  * Indicates that this surface is the primary surface for the left eye.
  935.  * The primary surface for the left eye represents what the user is seeing
  936.  * at the moment with the users left eye.  When this surface is created the
  937.  * DDSCAPS_PRIMARYSURFACE represents what the user is seeing with the users
  938.  * right eye.
  939.  */
  940. #define DDSCAPS_PRIMARYSURFACELEFT              0x00000400l
  941.  
  942. /*
  943.  * Indicates that this surface memory was allocated in system memory
  944.  */
  945. #define DDSCAPS_SYSTEMMEMORY                    0x00000800l
  946.  
  947. /*
  948.  * Indicates that this surface can be used as a 3D texture.  It does not
  949.  * indicate whether or not the surface is being used for that purpose.
  950.  */
  951. #define DDSCAPS_TEXTURE                         0x00001000l
  952.  
  953. /*
  954.  * Indicates that a surface may be a destination for 3D rendering.  This
  955.  * bit must be set in order to query for a Direct3D Device Interface 
  956.  * from this surface.
  957.  */
  958. #define DDSCAPS_3DDEVICE                        0x00002000l
  959.  
  960. /*
  961.  * Indicates that this surface exists in video memory.
  962.  */
  963. #define DDSCAPS_VIDEOMEMORY                     0x00004000l
  964.  
  965. /*
  966.  * Indicates that changes made to this surface are immediately visible.  
  967.  * It is always set for the primary surface and is set for overlays while
  968.  * they are being overlayed and texture maps while they are being textured.
  969.  */
  970. #define DDSCAPS_VISIBLE                         0x00008000l
  971.  
  972. /*
  973.  * Indicates that only writes are permitted to the surface.  Read accesses 
  974.  * from the surface may or may not generate a protection fault, but the 
  975.  * results of a read from this surface will not be meaningful.  READ ONLY.
  976.  */
  977. #define DDSCAPS_WRITEONLY                       0x00010000l
  978.  
  979. /*
  980.  * Indicates that this surface is a z buffer. A z buffer does not contain
  981.  * displayable information.  Instead it contains bit depth information that is
  982.  * used to determine which pixels are visible and which are obscured. 
  983.  */
  984. #define DDSCAPS_ZBUFFER                         0x00020000l
  985.  
  986. /*
  987.  * Indicates surface will have a DC associated long term
  988.  */
  989. #define DDSCAPS_OWNDC                           0x00040000l
  990.  
  991. /*
  992.  * Indicates surface should be able to receive live video
  993.  */
  994. #define DDSCAPS_LIVEVIDEO                       0x00080000l
  995.  
  996. /*
  997.  * Indicates surface should be able to have a stream decompressed
  998.  * to it by the hardware.
  999.  */
  1000. #define DDSCAPS_HWCODEC                         0x00100000l
  1001.  
  1002. /*
  1003.  * Surface is a 320x200 or 320x240 ModeX surface
  1004.  */
  1005. #define DDSCAPS_MODEX                           0x00200000l
  1006.  
  1007. /*
  1008.  * Indicates surface is one level of a mip-map. This surface will
  1009.  * be attached to other DDSCAPS_MIPMAP surfaces to form the mip-map.
  1010.  * This can be done explicitly, by creating a number of surfaces and
  1011.  * attaching them with AddAttachedSurface or by implicitly by CreateSurface.
  1012.  * If this bit is set then DDSCAPS_TEXTURE must also be set.
  1013.  */
  1014. #define DDSCAPS_MIPMAP                          0x00400000l
  1015.  
  1016.  
  1017.  
  1018. /*
  1019.  * Indicates that memory for the surface is not allocated until the surface
  1020.  * is loaded (via the Direct3D texture Load() function).
  1021.  */
  1022. #define DDSCAPS_ALLOCONLOAD                     0x04000000l
  1023.  
  1024.  
  1025.  
  1026.  /****************************************************************************
  1027.  *
  1028.  * DIRECTDRAW DRIVER CAPABILITY FLAGS
  1029.  *
  1030.  ****************************************************************************/
  1031.  
  1032. /*
  1033.  * Display hardware has 3D acceleration.
  1034.  */
  1035. #define DDCAPS_3D                       0x00000001l
  1036.  
  1037. /*
  1038.  * Indicates that DirectDraw will support only dest rectangles that are aligned
  1039.  * on DIRECTDRAWCAPS.dwAlignBoundaryDest boundaries of the surface, respectively.
  1040.  * READ ONLY.
  1041.  */
  1042. #define DDCAPS_ALIGNBOUNDARYDEST        0x00000002l
  1043.  
  1044. /*
  1045.  * Indicates that DirectDraw will support only source rectangles  whose sizes in 
  1046.  * BYTEs are DIRECTDRAWCAPS.dwAlignSizeDest multiples, respectively.  READ ONLY.
  1047.  */
  1048. #define DDCAPS_ALIGNSIZEDEST            0x00000004l
  1049. /*
  1050.  * Indicates that DirectDraw will support only source rectangles that are aligned
  1051.  * on DIRECTDRAWCAPS.dwAlignBoundarySrc boundaries of the surface, respectively.
  1052.  * READ ONLY.
  1053.  */
  1054. #define DDCAPS_ALIGNBOUNDARYSRC         0x00000008l
  1055.  
  1056. /*
  1057.  * Indicates that DirectDraw will support only source rectangles  whose sizes in 
  1058.  * BYTEs are DIRECTDRAWCAPS.dwAlignSizeSrc multiples, respectively.  READ ONLY.
  1059.  */
  1060. #define DDCAPS_ALIGNSIZESRC             0x00000010l
  1061.  
  1062. /*
  1063.  * Indicates that DirectDraw will create video memory surfaces that have a stride 
  1064.  * alignment equal to DIRECTDRAWCAPS.dwAlignStride.  READ ONLY.
  1065.  */
  1066. #define DDCAPS_ALIGNSTRIDE              0x00000020l
  1067.  
  1068. /*
  1069.  * Display hardware is capable of blt operations.
  1070.  */
  1071. #define DDCAPS_BLT                      0x00000040l
  1072.  
  1073. /*
  1074.  * Display hardware is capable of asynchronous blt operations.
  1075.  */
  1076. #define DDCAPS_BLTQUEUE                 0x00000080l
  1077.  
  1078. /*
  1079.  * Display hardware is capable of color space conversions during the blt operation.
  1080.  */
  1081. #define DDCAPS_BLTFOURCC                0x00000100l
  1082.  
  1083. /*
  1084.  * Display hardware is capable of stretching during blt operations.
  1085.  */
  1086. #define DDCAPS_BLTSTRETCH               0x00000200l
  1087.  
  1088. /*
  1089.  * Display hardware is shared with GDI.
  1090.  */
  1091. #define DDCAPS_GDI                      0x00000400l
  1092.  
  1093. /*
  1094.  * Display hardware can overlay.
  1095.  */
  1096. #define DDCAPS_OVERLAY                  0x00000800l
  1097.  
  1098. /*
  1099.  * Set if display hardware supports overlays but can not clip them.
  1100.  */
  1101. #define DDCAPS_OVERLAYCANTCLIP          0x00001000l
  1102.  
  1103. /*
  1104.  * Indicates that overlay hardware is capable of color space conversions during
  1105.  * the overlay operation.
  1106.  */
  1107. #define DDCAPS_OVERLAYFOURCC            0x00002000l
  1108.  
  1109. /*
  1110.  * Indicates that stretching can be done by the overlay hardware.
  1111.  */
  1112. #define DDCAPS_OVERLAYSTRETCH           0x00004000l
  1113.  
  1114. /*
  1115.  * Indicates that unique DirectDrawPalettes can be created for DirectDrawSurfaces
  1116.  * other than the primary surface.
  1117.  */
  1118. #define DDCAPS_PALETTE                  0x00008000l
  1119.  
  1120. /*
  1121.  * Indicates that palette changes can be syncd with the veritcal refresh.
  1122.  */
  1123. #define DDCAPS_PALETTEVSYNC             0x00010000l
  1124.  
  1125. /*
  1126.  * Display hardware can return the current scan line.
  1127.  */
  1128. #define DDCAPS_READSCANLINE             0x00020000l
  1129.  
  1130. /*
  1131.  * Display hardware has stereo vision capabilities.  DDSCAPS_PRIMARYSURFACELEFT 
  1132.  * can be created.
  1133.  */
  1134. #define DDCAPS_STEREOVIEW               0x00040000l
  1135.  
  1136. /*
  1137.  * Display hardware is capable of generating a vertical blank interrupt.
  1138.  */
  1139. #define DDCAPS_VBI                      0x00080000l
  1140.  
  1141. /*
  1142.  * Supports the use of z buffers with blt operations.
  1143.  */
  1144. #define DDCAPS_ZBLTS                    0x00100000l
  1145.  
  1146. /*
  1147.  * Supports Z Ordering of overlays.
  1148.  */
  1149. #define DDCAPS_ZOVERLAYS                0x00200000l
  1150.  
  1151. /*
  1152.  * Supports color key
  1153.  */
  1154. #define DDCAPS_COLORKEY                 0x00400000l
  1155.  
  1156. /*
  1157.  * Supports alpha surfaces
  1158.  */
  1159. #define DDCAPS_ALPHA                    0x00800000l
  1160.  
  1161. /*
  1162.  * colorkey is hardware assisted(DDCAPS_COLORKEY will also be set)
  1163.  */
  1164. #define DDCAPS_COLORKEYHWASSIST         0x01000000l
  1165.  
  1166. /*
  1167.  * no hardware support at all
  1168.  */
  1169. #define DDCAPS_NOHARDWARE               0x02000000l
  1170.  
  1171. /*
  1172.  * Display hardware is capable of color fill with bltter
  1173.  */
  1174. #define DDCAPS_BLTCOLORFILL             0x04000000l
  1175.  
  1176. /*
  1177.  * Display hardware is bank switched, and potentially very slow at
  1178.  * random access to VRAM.
  1179.  */
  1180. #define DDCAPS_BANKSWITCHED             0x08000000l
  1181.  
  1182. /*
  1183.  * Display hardware is capable of depth filling Z-buffers with bltter
  1184.  */
  1185. #define DDCAPS_BLTDEPTHFILL             0x10000000l
  1186.  
  1187. /*
  1188.  * Display hardware is capable of clipping while bltting.
  1189.  */
  1190. #define DDCAPS_CANCLIP                  0x20000000l
  1191.  
  1192. /*
  1193.  * Display hardware is capable of clipping while stretch bltting.
  1194.  */
  1195. #define DDCAPS_CANCLIPSTRETCHED         0x40000000l
  1196.  
  1197. /*
  1198.  * Display hardware is capable of bltting to or from system memory
  1199.  */
  1200. #define DDCAPS_CANBLTSYSMEM             0x80000000l
  1201.  
  1202.  
  1203.  /****************************************************************************
  1204.  *
  1205.  * MORE DIRECTDRAW DRIVER CAPABILITY FLAGS (dwCaps2)
  1206.  *
  1207.  ****************************************************************************/
  1208.  
  1209. /*
  1210.  * Display hardware is certified
  1211.  */
  1212. #define DDCAPS2_CERTIFIED               0x00000001l
  1213.  
  1214. /*
  1215.  * Driver cannot interleave 2D operations (lock and blt) to surfaces with
  1216.  * Direct3D rendering operations between calls to BeginScene() and EndScene()
  1217.  */
  1218. #define DDCAPS2_NO2DDURING3DSCENE       0x00000002l
  1219.  
  1220. /****************************************************************************
  1221.  *
  1222.  * DIRECTDRAW FX ALPHA CAPABILITY FLAGS
  1223.  *
  1224.  ****************************************************************************/
  1225.  
  1226. /*
  1227.  * Supports alpha blending around the edge of a source color keyed surface.
  1228.  * For Blt.
  1229.  */
  1230. #define DDFXALPHACAPS_BLTALPHAEDGEBLEND         0x00000001l
  1231.  
  1232. /*
  1233.  * Supports alpha information in the pixel format.  The bit depth of alpha 
  1234.  * information in the pixel format can be 1,2,4, or 8.  The alpha value becomes
  1235.  * more opaque as the alpha value increases.  (0 is transparent.)
  1236.  * For Blt.
  1237.  */
  1238. #define DDFXALPHACAPS_BLTALPHAPIXELS            0x00000002l
  1239.  
  1240. /*
  1241.  * Supports alpha information in the pixel format.  The bit depth of alpha 
  1242.  * information in the pixel format can be 1,2,4, or 8.  The alpha value 
  1243.  * becomes more transparent as the alpha value increases.  (0 is opaque.) 
  1244.  * This flag can only be set if DDCAPS_ALPHA is set.
  1245.  * For Blt.
  1246.  */
  1247. #define DDFXALPHACAPS_BLTALPHAPIXELSNEG         0x00000004l
  1248.  
  1249. /*
  1250.  * Supports alpha only surfaces.  The bit depth of an alpha only surface can be
  1251.  * 1,2,4, or 8.  The alpha value becomes more opaque as the alpha value increases.
  1252.  * (0 is transparent.)
  1253.  * For Blt.
  1254.  */
  1255. #define DDFXALPHACAPS_BLTALPHASURFACES          0x00000008l
  1256.  
  1257. /*
  1258.  * The depth of the alpha channel data can range can be 1,2,4, or 8.  
  1259.  * The NEG suffix indicates that this alpha channel becomes more transparent
  1260.  * as the alpha value increases. (0 is opaque.)  This flag can only be set if
  1261.  * DDCAPS_ALPHA is set.
  1262.  * For Blt.
  1263.  */
  1264. #define DDFXALPHACAPS_BLTALPHASURFACESNEG       0x00000010l
  1265.  
  1266. /*
  1267.  * Supports alpha blending around the edge of a source color keyed surface.
  1268.  * For Overlays.
  1269.  */
  1270. #define DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND     0x00000020l
  1271.  
  1272. /*
  1273.  * Supports alpha information in the pixel format.  The bit depth of alpha 
  1274.  * information in the pixel format can be 1,2,4, or 8.  The alpha value becomes
  1275.  * more opaque as the alpha value increases.  (0 is transparent.)
  1276.  * For Overlays.
  1277.  */
  1278. #define DDFXALPHACAPS_OVERLAYALPHAPIXELS        0x00000040l
  1279.  
  1280. /*
  1281.  * Supports alpha information in the pixel format.  The bit depth of alpha 
  1282.  * information in the pixel format can be 1,2,4, or 8.  The alpha value 
  1283.  * becomes more transparent as the alpha value increases.  (0 is opaque.) 
  1284.  * This flag can only be set if DDCAPS_ALPHA is set.
  1285.  * For Overlays.
  1286.  */
  1287. #define DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG     0x00000080l
  1288.  
  1289. /*
  1290.  * Supports alpha only surfaces.  The bit depth of an alpha only surface can be
  1291.  * 1,2,4, or 8.  The alpha value becomes more opaque as the alpha value increases.
  1292.  * (0 is transparent.)
  1293.  * For Overlays.
  1294.  */
  1295. #define DDFXALPHACAPS_OVERLAYALPHASURFACES      0x00000100l
  1296.  
  1297. /*
  1298.  * The depth of the alpha channel data can range can be 1,2,4, or 8.  
  1299.  * The NEG suffix indicates that this alpha channel becomes more transparent
  1300.  * as the alpha value increases. (0 is opaque.)  This flag can only be set if
  1301.  * DDCAPS_ALPHA is set.
  1302.  * For Overlays.
  1303.  */
  1304. #define DDFXALPHACAPS_OVERLAYALPHASURFACESNEG   0x00000200l
  1305.  
  1306. /****************************************************************************
  1307.  *
  1308.  * DIRECTDRAW FX CAPABILITY FLAGS
  1309.  *
  1310.  ****************************************************************************/
  1311.  
  1312. /*
  1313.  * Uses arithmetic operations to stretch and shrink surfaces during blt
  1314.  * rather than pixel doubling techniques.  Along the Y axis.
  1315.  */
  1316. #define DDFXCAPS_BLTARITHSTRETCHY       0x00000020l
  1317.  
  1318. /*
  1319.  * Uses arithmetic operations to stretch during blt
  1320.  * rather than pixel doubling techniques.  Along the Y axis. Only
  1321.  * works for x1, x2, etc.
  1322.  */
  1323. #define DDFXCAPS_BLTARITHSTRETCHYN      0x00000010l
  1324.  
  1325. /*
  1326.  * Supports mirroring left to right in blt.
  1327.  */
  1328. #define DDFXCAPS_BLTMIRRORLEFTRIGHT     0x00000040l
  1329.  
  1330. /*
  1331.  * Supports mirroring top to bottom in blt.
  1332.  */
  1333. #define DDFXCAPS_BLTMIRRORUPDOWN        0x00000080l
  1334.  
  1335. /*
  1336.  * Supports arbitrary rotation for blts.
  1337.  */
  1338. #define DDFXCAPS_BLTROTATION            0x00000100l
  1339.  
  1340. /*
  1341.  * Supports 90 degree rotations for blts.
  1342.  */
  1343. #define DDFXCAPS_BLTROTATION90          0x00000200l
  1344.  
  1345. /*
  1346.  * DirectDraw supports arbitrary shrinking of a surface along the
  1347.  * x axis (horizontal direction) for blts.
  1348.  */
  1349. #define DDFXCAPS_BLTSHRINKX             0x00000400l
  1350.  
  1351. /*
  1352.  * DirectDraw supports integer shrinking (1x,2x,) of a surface
  1353.  * along the x axis (horizontal direction) for blts.
  1354.  */
  1355. #define DDFXCAPS_BLTSHRINKXN            0x00000800l
  1356.  
  1357. /*
  1358.  * DirectDraw supports arbitrary shrinking of a surface along the
  1359.  * y axis (horizontal direction) for blts.  
  1360.  */
  1361. #define DDFXCAPS_BLTSHRINKY             0x00001000l
  1362.  
  1363. /*
  1364.  * DirectDraw supports integer shrinking (1x,2x,) of a surface
  1365.  * along the y axis (vertical direction) for blts.  
  1366.  */
  1367. #define DDFXCAPS_BLTSHRINKYN            0x00002000l
  1368.  
  1369. /*
  1370.  * DirectDraw supports arbitrary stretching of a surface along the
  1371.  * x axis (horizontal direction) for blts.
  1372.  */
  1373. #define DDFXCAPS_BLTSTRETCHX            0x00004000l
  1374.  
  1375. /*
  1376.  * DirectDraw supports integer stretching (1x,2x,) of a surface
  1377.  * along the x axis (horizontal direction) for blts.
  1378.  */
  1379. #define DDFXCAPS_BLTSTRETCHXN           0x00008000l
  1380.  
  1381. /*
  1382.  * DirectDraw supports arbitrary stretching of a surface along the
  1383.  * y axis (horizontal direction) for blts.  
  1384.  */
  1385. #define DDFXCAPS_BLTSTRETCHY            0x00010000l
  1386.  
  1387. /*
  1388.  * DirectDraw supports integer stretching (1x,2x,) of a surface
  1389.  * along the y axis (vertical direction) for blts.  
  1390.  */
  1391. #define DDFXCAPS_BLTSTRETCHYN           0x00020000l
  1392.  
  1393. /*
  1394.  * Uses arithmetic operations to stretch and shrink surfaces during 
  1395.  * overlay rather than pixel doubling techniques.  Along the Y axis 
  1396.  * for overlays.
  1397.  */
  1398. #define DDFXCAPS_OVERLAYARITHSTRETCHY   0x00040000l
  1399.  
  1400. /*
  1401.  * Uses arithmetic operations to stretch surfaces during 
  1402.  * overlay rather than pixel doubling techniques.  Along the Y axis 
  1403.  * for overlays. Only works for x1, x2, etc.
  1404.  */
  1405. #define DDFXCAPS_OVERLAYARITHSTRETCHYN  0x00000008l
  1406.  
  1407. /*
  1408.  * DirectDraw supports arbitrary shrinking of a surface along the
  1409.  * x axis (horizontal direction) for overlays.
  1410.  */
  1411. #define DDFXCAPS_OVERLAYSHRINKX         0x00080000l
  1412.  
  1413. /*
  1414.  * DirectDraw supports integer shrinking (1x,2x,) of a surface
  1415.  * along the x axis (horizontal direction) for overlays.
  1416.  */
  1417. #define DDFXCAPS_OVERLAYSHRINKXN        0x00100000l
  1418.  
  1419. /*
  1420.  * DirectDraw supports arbitrary shrinking of a surface along the
  1421.  * y axis (horizontal direction) for overlays.  
  1422.  */
  1423. #define DDFXCAPS_OVERLAYSHRINKY         0x00200000l
  1424.  
  1425. /*
  1426.  * DirectDraw supports integer shrinking (1x,2x,) of a surface
  1427.  * along the y axis (vertical direction) for overlays.  
  1428.  */
  1429. #define DDFXCAPS_OVERLAYSHRINKYN        0x00400000l
  1430.  
  1431. /*
  1432.  * DirectDraw supports arbitrary stretching of a surface along the
  1433.  * x axis (horizontal direction) for overlays.
  1434.  */
  1435. #define DDFXCAPS_OVERLAYSTRETCHX        0x00800000l
  1436.  
  1437. /*
  1438.  * DirectDraw supports integer stretching (1x,2x,) of a surface
  1439.  * along the x axis (horizontal direction) for overlays.
  1440.  */
  1441. #define DDFXCAPS_OVERLAYSTRETCHXN       0x01000000l
  1442.  
  1443. /*
  1444.  * DirectDraw supports arbitrary stretching of a surface along the
  1445.  * y axis (horizontal direction) for overlays.  
  1446.  */
  1447. #define DDFXCAPS_OVERLAYSTRETCHY        0x02000000l
  1448.  
  1449. /*
  1450.  * DirectDraw supports integer stretching (1x,2x,) of a surface
  1451.  * along the y axis (vertical direction) for overlays.  
  1452.  */
  1453. #define DDFXCAPS_OVERLAYSTRETCHYN       0x04000000l
  1454.  
  1455. /*
  1456.  * DirectDraw supports mirroring of overlays across the vertical axis
  1457.  */
  1458. #define DDFXCAPS_OVERLAYMIRRORLEFTRIGHT 0x08000000l
  1459.  
  1460. /*
  1461.  * DirectDraw supports mirroring of overlays across the horizontal axis
  1462.  */
  1463. #define DDFXCAPS_OVERLAYMIRRORUPDOWN    0x10000000l
  1464.  
  1465. /****************************************************************************
  1466.  *
  1467.  * DIRECTDRAW STEREO VIEW CAPABILITIES
  1468.  *
  1469.  ****************************************************************************/
  1470.  
  1471. /*
  1472.  * The stereo view is accomplished via enigma encoding.
  1473.  */
  1474. #define DDSVCAPS_ENIGMA                 0x00000001l
  1475.  
  1476. /*
  1477.  * The stereo view is accomplished via high frequency flickering.
  1478.  */
  1479. #define DDSVCAPS_FLICKER                0x00000002l
  1480.  
  1481. /*
  1482.  * The stereo view is accomplished via red and blue filters applied
  1483.  * to the left and right eyes.  All images must adapt their colorspaces
  1484.  * for this process.
  1485.  */
  1486. #define DDSVCAPS_REDBLUE                0x00000004l
  1487.  
  1488. /*
  1489.  * The stereo view is accomplished with split screen technology.
  1490.  */
  1491. #define DDSVCAPS_SPLIT                  0x00000008l
  1492.  
  1493. /****************************************************************************
  1494.  *
  1495.  * DIRECTDRAWPALETTE CAPABILITIES
  1496.  *
  1497.  ****************************************************************************/
  1498.  
  1499. /*
  1500.  * Index is 4 bits.  There are sixteen color entries in the palette table.
  1501.  */
  1502. #define DDPCAPS_4BIT                    0x00000001l
  1503.  
  1504. /*
  1505.  * Index is onto a 8 bit color index.  This field is only valid with the
  1506.  * DDPCAPS_1BIT, DDPCAPS_2BIT or DDPCAPS_4BIT capability and the target
  1507.  * surface is in 8bpp. Each color entry is one byte long and is an index
  1508.  * into destination surface's 8bpp palette.
  1509.  */
  1510. #define DDPCAPS_8BITENTRIES             0x00000002l
  1511.  
  1512. /*
  1513.  * Index is 8 bits.  There are 256 color entries in the palette table.
  1514.  */
  1515. #define DDPCAPS_8BIT                    0x00000004l
  1516.  
  1517. /*
  1518.  * Indicates that this DIRECTDRAWPALETTE should use the palette color array
  1519.  * passed into the lpDDColorArray parameter to initialize the DIRECTDRAWPALETTE
  1520.  * object.
  1521.  */
  1522. #define DDPCAPS_INITIALIZE              0x00000008l
  1523.  
  1524. /*
  1525.  * This palette is the one attached to the primary surface.  Changing this
  1526.  * table has immediate effect on the display unless DDPSETPAL_VSYNC is specified
  1527.  * and supported.
  1528.  */
  1529. #define DDPCAPS_PRIMARYSURFACE          0x00000010l
  1530.  
  1531. /*
  1532.  * This palette is the one attached to the primary surface left.  Changing
  1533.  * this table has immediate effect on the display for the left eye unless
  1534.  * DDPSETPAL_VSYNC is specified and supported.
  1535.  */
  1536. #define DDPCAPS_PRIMARYSURFACELEFT      0x00000020l
  1537.  
  1538. /*
  1539.  * This palette can have all 256 entries defined
  1540.  */
  1541. #define DDPCAPS_ALLOW256                0x00000040l
  1542.  
  1543. /*
  1544.  * This palette can have modifications to it synced with the monitors
  1545.  * refresh rate.
  1546.  */
  1547. #define DDPCAPS_VSYNC                   0x00000080l
  1548.  
  1549. /*
  1550.  * Index is 1 bit.  There are two color entries in the palette table.
  1551.  */
  1552. #define DDPCAPS_1BIT                    0x00000100l
  1553.  
  1554. /*
  1555.  * Index is 2 bit.  There are four color entries in the palette table.
  1556.  */
  1557. #define DDPCAPS_2BIT                    0x00000200l
  1558.  
  1559.  
  1560. /****************************************************************************
  1561.  *
  1562.  * DIRECTDRAWPALETTE SETENTRY CONSTANTS
  1563.  *
  1564.  ****************************************************************************/
  1565.  
  1566.  
  1567. /****************************************************************************
  1568.  *
  1569.  * DIRECTDRAWPALETTE GETENTRY CONSTANTS
  1570.  *
  1571.  ****************************************************************************/
  1572.  
  1573. /* 0 is the only legal value */
  1574.  
  1575. /****************************************************************************
  1576.  *
  1577.  * DIRECTDRAWSURFACE SETPALETTE CONSTANTS
  1578.  *
  1579.  ****************************************************************************/
  1580.  
  1581.  
  1582. /****************************************************************************
  1583.  *
  1584.  * DIRECTDRAW BITDEPTH CONSTANTS
  1585.  *
  1586.  * NOTE:  These are only used to indicate supported bit depths.   These
  1587.  * are flags only, they are not to be used as an actual bit depth.   The
  1588.  * absolute numbers 1, 2, 4, 8, 16, 24 and 32 are used to indicate actual
  1589.  * bit depths in a surface or for changing the display mode.
  1590.  *
  1591.  ****************************************************************************/
  1592.  
  1593. /*
  1594.  * 1 bit per pixel.
  1595.  */
  1596. #define DDBD_1                  0x00004000l
  1597.  
  1598. /*
  1599.  * 2 bits per pixel.
  1600.  */
  1601. #define DDBD_2                  0x00002000l
  1602.  
  1603. /*
  1604.  * 4 bits per pixel.
  1605.  */
  1606. #define DDBD_4                  0x00001000l
  1607.  
  1608. /*
  1609.  * 8 bits per pixel.
  1610.  */
  1611. #define DDBD_8                  0x00000800l
  1612.  
  1613. /*
  1614.  * 16 bits per pixel.
  1615.  */
  1616. #define DDBD_16                 0x00000400l
  1617.  
  1618. /*
  1619.  * 24 bits per pixel.
  1620.  */
  1621. #define DDBD_24                 0X00000200l
  1622.  
  1623. /*
  1624.  * 32 bits per pixel.
  1625.  */
  1626. #define DDBD_32                 0x00000100l
  1627.  
  1628. /****************************************************************************
  1629.  *
  1630.  * DIRECTDRAWSURFACE SET/GET COLOR KEY FLAGS
  1631.  *
  1632.  ****************************************************************************/
  1633.  
  1634. /*
  1635.  * Set if the structure contains a color space.  Not set if the structure
  1636.  * contains a single color key.
  1637.  */
  1638. #define DDCKEY_COLORSPACE       0x00000001l
  1639.  
  1640. /*
  1641.  * Set if the structure specifies a color key or color space which is to be
  1642.  * used as a destination color key for blt operations.
  1643.  */
  1644. #define DDCKEY_DESTBLT          0x00000002l
  1645.  
  1646. /*
  1647.  * Set if the structure specifies a color key or color space which is to be
  1648.  * used as a destination color key for overlay operations.
  1649.  */
  1650. #define DDCKEY_DESTOVERLAY      0x00000004l
  1651.  
  1652. /*
  1653.  * Set if the structure specifies a color key or color space which is to be
  1654.  * used as a source color key for blt operations.
  1655.  */
  1656. #define DDCKEY_SRCBLT           0x00000008l
  1657.  
  1658. /*
  1659.  * Set if the structure specifies a color key or color space which is to be
  1660.  * used as a source color key for overlay operations.
  1661.  */
  1662. #define DDCKEY_SRCOVERLAY       0x00000010l
  1663.  
  1664.  
  1665. /****************************************************************************
  1666.  *
  1667.  * DIRECTDRAW COLOR KEY CAPABILITY FLAGS
  1668.  *
  1669.  ****************************************************************************/
  1670.  
  1671. /*
  1672.  * Supports transparent blting using a color key to identify the replaceable 
  1673.  * bits of the destination surface for RGB colors.
  1674.  */
  1675. #define DDCKEYCAPS_DESTBLT                      0x00000001l
  1676.  
  1677. /*
  1678.  * Supports transparent blting using a color space to identify the replaceable
  1679.  * bits of the destination surface for RGB colors.
  1680.  */
  1681. #define DDCKEYCAPS_DESTBLTCLRSPACE              0x00000002l
  1682.  
  1683. /*
  1684.  * Supports transparent blting using a color space to identify the replaceable
  1685.  * bits of the destination surface for YUV colors.
  1686.  */
  1687. #define DDCKEYCAPS_DESTBLTCLRSPACEYUV           0x00000004l
  1688.  
  1689. /*
  1690.  * Supports transparent blting using a color key to identify the replaceable 
  1691.  * bits of the destination surface for YUV colors.
  1692.  */
  1693. #define DDCKEYCAPS_DESTBLTYUV                   0x00000008l
  1694.  
  1695. /*
  1696.  * Supports overlaying using colorkeying of the replaceable bits of the surface
  1697.  * being overlayed for RGB colors.
  1698.  */
  1699. #define DDCKEYCAPS_DESTOVERLAY                  0x00000010l
  1700.  
  1701. /*
  1702.  * Supports a color space as the color key for the destination for RGB colors.
  1703.  */
  1704. #define DDCKEYCAPS_DESTOVERLAYCLRSPACE          0x00000020l
  1705.  
  1706. /*
  1707.  * Supports a color space as the color key for the destination for YUV colors.
  1708.  */
  1709. #define DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV       0x00000040l
  1710.  
  1711. /*
  1712.  * Supports only one active destination color key value for visible overlay
  1713.  * surfaces.
  1714.  */
  1715. #define DDCKEYCAPS_DESTOVERLAYONEACTIVE         0x00000080l
  1716.  
  1717. /*
  1718.  * Supports overlaying using colorkeying of the replaceable bits of the 
  1719.  * surface being overlayed for YUV colors.
  1720.  */
  1721. #define DDCKEYCAPS_DESTOVERLAYYUV               0x00000100l
  1722.  
  1723. /*
  1724.  * Supports transparent blting using the color key for the source with
  1725.  * this surface for RGB colors.
  1726.  */
  1727. #define DDCKEYCAPS_SRCBLT                       0x00000200l
  1728.  
  1729. /*
  1730.  * Supports transparent blting using a color space for the source with
  1731.  * this surface for RGB colors.
  1732.  */
  1733. #define DDCKEYCAPS_SRCBLTCLRSPACE               0x00000400l
  1734.  
  1735. /*
  1736.  * Supports transparent blting using a color space for the source with
  1737.  * this surface for YUV colors.
  1738.  */
  1739. #define DDCKEYCAPS_SRCBLTCLRSPACEYUV            0x00000800l
  1740.  
  1741. /*
  1742.  * Supports transparent blting using the color key for the source with
  1743.  * this surface for YUV colors.
  1744.  */
  1745. #define DDCKEYCAPS_SRCBLTYUV                    0x00001000l
  1746.  
  1747. /*
  1748.  * Supports overlays using the color key for the source with this
  1749.  * overlay surface for RGB colors.
  1750.  */
  1751. #define DDCKEYCAPS_SRCOVERLAY                   0x00002000l
  1752.  
  1753. /*
  1754.  * Supports overlays using a color space as the source color key for
  1755.  * the overlay surface for RGB colors.
  1756.  */
  1757. #define DDCKEYCAPS_SRCOVERLAYCLRSPACE           0x00004000l
  1758.  
  1759. /*
  1760.  * Supports overlays using a color space as the source color key for
  1761.  * the overlay surface for YUV colors.
  1762.  */
  1763. #define DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV        0x00008000l
  1764.  
  1765. /*
  1766.  * Supports only one active source color key value for visible
  1767.  * overlay surfaces.
  1768.  */
  1769. #define DDCKEYCAPS_SRCOVERLAYONEACTIVE          0x00010000l
  1770.  
  1771. /*
  1772.  * Supports overlays using the color key for the source with this
  1773.  * overlay surface for YUV colors.
  1774.  */
  1775. #define DDCKEYCAPS_SRCOVERLAYYUV                0x00020000l
  1776.  
  1777. /*
  1778.  * there are no bandwidth trade-offs for using colorkey with an overlay
  1779.  */
  1780. #define DDCKEYCAPS_NOCOSTOVERLAY                0x00040000l
  1781.  
  1782.  
  1783. /****************************************************************************
  1784.  *
  1785.  * DIRECTDRAW PIXELFORMAT FLAGS
  1786.  *
  1787.  ****************************************************************************/
  1788.  
  1789. /*
  1790.  * The surface has alpha channel information in the pixel format.
  1791.  */
  1792. #define DDPF_ALPHAPIXELS                        0x00000001l
  1793.  
  1794. /*
  1795.  * The pixel format contains alpha only information
  1796.  */
  1797. #define DDPF_ALPHA                              0x00000002l
  1798.  
  1799. /*
  1800.  * The FourCC code is valid.
  1801.  */
  1802. #define DDPF_FOURCC                             0x00000004l
  1803.  
  1804. /*
  1805.  * The surface is 4-bit color indexed.
  1806.  */
  1807. #define DDPF_PALETTEINDEXED4                    0x00000008l
  1808.  
  1809. /*
  1810.  * The surface is indexed into a palette which stores indices
  1811.  * into the destination surface's 8-bit palette.
  1812.  */
  1813. #define DDPF_PALETTEINDEXEDTO8                  0x00000010l
  1814.  
  1815. /*
  1816.  * The surface is 8-bit color indexed.
  1817.  */
  1818. #define DDPF_PALETTEINDEXED8                    0x00000020l
  1819.  
  1820. /*
  1821.  * The RGB data in the pixel format structure is valid.
  1822.  */
  1823. #define DDPF_RGB                                0x00000040l
  1824.  
  1825. /*
  1826.  * The surface will accept pixel data in the format specified
  1827.  * and compress it during the write.
  1828.  */
  1829. #define DDPF_COMPRESSED                         0x00000080l
  1830.  
  1831. /*
  1832.  * The surface will accept RGB data and translate it during
  1833.  * the write to YUV data.  The format of the data to be written
  1834.  * will be contained in the pixel format structure.  The DDPF_RGB
  1835.  * flag will be set. 
  1836.  */
  1837. #define DDPF_RGBTOYUV                           0x00000100l
  1838.  
  1839. /*
  1840.  * pixel format is YUV - YUV data in pixel format struct is valid
  1841.  */
  1842. #define DDPF_YUV                                0x00000200l
  1843.  
  1844. /*
  1845.  * pixel format is a z buffer only surface
  1846.  */
  1847. #define DDPF_ZBUFFER                            0x00000400l
  1848.  
  1849. /*
  1850.  * The surface is 1-bit color indexed.
  1851.  */
  1852. #define DDPF_PALETTEINDEXED1                    0x00000800l
  1853.  
  1854. /*
  1855.  * The surface is 2-bit color indexed.
  1856.  */
  1857. #define DDPF_PALETTEINDEXED2                    0x00001000l
  1858.  
  1859. /*===========================================================================
  1860.  *
  1861.  *
  1862.  * DIRECTDRAW CALLBACK FLAGS
  1863.  *
  1864.  *
  1865.  *==========================================================================*/
  1866.  
  1867. /****************************************************************************
  1868.  *
  1869.  * DIRECTDRAW ENUMSURFACES FLAGS
  1870.  *
  1871.  ****************************************************************************/
  1872.  
  1873. /*
  1874.  * Enumerate all of the surfaces that meet the search criterion.
  1875.  */
  1876. #define DDENUMSURFACES_ALL                      0x00000001l
  1877.  
  1878. /*
  1879.  * A search hit is a surface that matches the surface description.
  1880.  */
  1881. #define DDENUMSURFACES_MATCH                    0x00000002l
  1882.  
  1883. /*
  1884.  * A search hit is a surface that does not match the surface description.
  1885.  */
  1886. #define DDENUMSURFACES_NOMATCH                  0x00000004l
  1887.  
  1888. /*
  1889.  * Enumerate the first surface that can be created which meets the search criterion.
  1890.  */
  1891. #define DDENUMSURFACES_CANBECREATED             0x00000008l
  1892.  
  1893. /*
  1894.  * Enumerate the surfaces that already exist that meet the search criterion.
  1895.  */
  1896. #define DDENUMSURFACES_DOESEXIST                0x00000010l
  1897.  
  1898.  
  1899. /****************************************************************************
  1900.  *
  1901.  * DIRECTDRAW ENUMDISPLAYMODES FLAGS
  1902.  *
  1903.  ****************************************************************************/
  1904.  
  1905. /*
  1906.  * Enumerate Modes with different refresh rates.  EnumDisplayModes guarantees
  1907.  * that a particular mode will be enumerated only once.  This flag specifies whether
  1908.  * the refresh rate is taken into account when determining if a mode is unique.
  1909.  */
  1910. #define DDEDM_REFRESHRATES                      0x00000001l
  1911.  
  1912.  
  1913. /****************************************************************************
  1914.  *
  1915.  * DIRECTDRAW SETCOOPERATIVELEVEL FLAGS
  1916.  *
  1917.  ****************************************************************************/
  1918.  
  1919. /*
  1920.  * Exclusive mode owner will be responsible for the entire primary surface.
  1921.  * GDI can be ignored. used with DD
  1922.  */
  1923. #define DDSCL_FULLSCREEN                        0x00000001l
  1924.  
  1925. /*
  1926.  * allow CTRL_ALT_DEL to work while in fullscreen exclusive mode 
  1927.  */
  1928. #define DDSCL_ALLOWREBOOT                       0x00000002l
  1929.  
  1930. /*
  1931.  * prevents DDRAW from modifying the application window.
  1932.  * prevents DDRAW from minimize/restore the application window on activation.
  1933.  */
  1934. #define DDSCL_NOWINDOWCHANGES                   0x00000004l
  1935.  
  1936. /*
  1937.  * app wants to work as a regular Windows application
  1938.  */
  1939. #define DDSCL_NORMAL                            0x00000008l
  1940.  
  1941. /*
  1942.  * app wants exclusive access
  1943.  */
  1944. #define DDSCL_EXCLUSIVE                         0x00000010l
  1945.  
  1946.  
  1947. /*
  1948.  * app can deal with non-windows display modes
  1949.  */
  1950. #define DDSCL_ALLOWMODEX                        0x00000040l
  1951.  
  1952.  
  1953. /****************************************************************************
  1954.  *
  1955.  * DIRECTDRAW BLT FLAGS
  1956.  *
  1957.  ****************************************************************************/
  1958.  
  1959. /*
  1960.  * Use the alpha information in the pixel format or the alpha channel surface
  1961.  * attached to the destination surface as the alpha channel for this blt.
  1962.  */
  1963. #define DDBLT_ALPHADEST                         0x00000001l
  1964.  
  1965. /*
  1966.  * Use the dwConstAlphaDest field in the DDBLTFX structure as the alpha channel
  1967.  * for the destination surface for this blt.
  1968.  */
  1969. #define DDBLT_ALPHADESTCONSTOVERRIDE            0x00000002l
  1970.  
  1971. /*
  1972.  * The NEG suffix indicates that the destination surface becomes more
  1973.  * transparent as the alpha value increases. (0 is opaque)
  1974.  */
  1975. #define DDBLT_ALPHADESTNEG                      0x00000004l
  1976.  
  1977. /*
  1978.  * Use the lpDDSAlphaDest field in the DDBLTFX structure as the alpha
  1979.  * channel for the destination for this blt.
  1980.  */
  1981. #define DDBLT_ALPHADESTSURFACEOVERRIDE          0x00000008l
  1982.  
  1983. /*
  1984.  * Use the dwAlphaEdgeBlend field in the DDBLTFX structure as the alpha channel
  1985.  * for the edges of the image that border the color key colors.
  1986.  */
  1987. #define DDBLT_ALPHAEDGEBLEND                    0x00000010l
  1988.  
  1989. /*
  1990.  * Use the alpha information in the pixel format or the alpha channel surface
  1991.  * attached to the source surface as the alpha channel for this blt.
  1992.  */
  1993. #define DDBLT_ALPHASRC                          0x00000020l
  1994.  
  1995. /*
  1996.  * Use the dwConstAlphaSrc field in the DDBLTFX structure as the alpha channel
  1997.  * for the source for this blt.
  1998.  */
  1999. #define DDBLT_ALPHASRCCONSTOVERRIDE             0x00000040l
  2000.  
  2001. /*
  2002.  * The NEG suffix indicates that the source surface becomes more transparent
  2003.  * as the alpha value increases. (0 is opaque)
  2004.  */
  2005. #define DDBLT_ALPHASRCNEG                       0x00000080l
  2006.  
  2007. /*
  2008.  * Use the lpDDSAlphaSrc field in the DDBLTFX structure as the alpha channel
  2009.  * for the source for this blt. 
  2010.  */
  2011. #define DDBLT_ALPHASRCSURFACEOVERRIDE           0x00000100l
  2012.  
  2013. /*
  2014.  * Do this blt asynchronously through the FIFO in the order received.  If
  2015.  * there is no room in the hardware FIFO fail the call.
  2016.  */
  2017. #define DDBLT_ASYNC                             0x00000200l
  2018.  
  2019. /*
  2020.  * Uses the dwFillColor field in the DDBLTFX structure as the RGB color
  2021.  * to fill the destination rectangle on the destination surface with.
  2022.  */
  2023. #define DDBLT_COLORFILL                         0x00000400l
  2024.  
  2025. /*
  2026.  * Uses the dwDDFX field in the DDBLTFX structure to specify the effects
  2027.  * to use for the blt.
  2028.  */
  2029. #define DDBLT_DDFX                              0x00000800l
  2030.  
  2031. /*
  2032.  * Uses the dwDDROPS field in the DDBLTFX structure to specify the ROPS
  2033.  * that are not part of the Win32 API.
  2034.  */
  2035. #define DDBLT_DDROPS                            0x00001000l
  2036.  
  2037. /*
  2038.  * Use the color key associated with the destination surface.
  2039.  */
  2040. #define DDBLT_KEYDEST                           0x00002000l
  2041.  
  2042. /*
  2043.  * Use the dckDestColorkey field in the DDBLTFX structure as the color key
  2044.  * for the destination surface.
  2045.  */
  2046. #define DDBLT_KEYDESTOVERRIDE                   0x00004000l
  2047.  
  2048. /*
  2049.  * Use the color key associated with the source surface.
  2050.  */
  2051. #define DDBLT_KEYSRC                            0x00008000l
  2052.  
  2053. /*
  2054.  * Use the dckSrcColorkey field in the DDBLTFX structure as the color key
  2055.  * for the source surface.
  2056.  */
  2057. #define DDBLT_KEYSRCOVERRIDE                    0x00010000l
  2058.  
  2059. /*
  2060.  * Use the dwROP field in the DDBLTFX structure for the raster operation
  2061.  * for this blt.  These ROPs are the same as the ones defined in the Win32 API.
  2062.  */
  2063. #define DDBLT_ROP                               0x00020000l
  2064.  
  2065. /*
  2066.  * Use the dwRotationAngle field in the DDBLTFX structure as the angle
  2067.  * (specified in 1/100th of a degree) to rotate the surface.
  2068.  */
  2069. #define DDBLT_ROTATIONANGLE                     0x00040000l
  2070.  
  2071. /*
  2072.  * Z-buffered blt using the z-buffers attached to the source and destination
  2073.  * surfaces and the dwZBufferOpCode field in the DDBLTFX structure as the
  2074.  * z-buffer opcode.
  2075.  */
  2076. #define DDBLT_ZBUFFER                           0x00080000l
  2077.  
  2078. /*
  2079.  * Z-buffered blt using the dwConstDest Zfield and the dwZBufferOpCode field
  2080.  * in the DDBLTFX structure as the z-buffer and z-buffer opcode respectively
  2081.  * for the destination.
  2082.  */
  2083. #define DDBLT_ZBUFFERDESTCONSTOVERRIDE          0x00100000l
  2084.  
  2085. /*
  2086.  * Z-buffered blt using the lpDDSDestZBuffer field and the dwZBufferOpCode
  2087.  * field in the DDBLTFX structure as the z-buffer and z-buffer opcode
  2088.  * respectively for the destination.
  2089.  */
  2090. #define DDBLT_ZBUFFERDESTOVERRIDE               0x00200000l
  2091.  
  2092. /*
  2093.  * Z-buffered blt using the dwConstSrcZ field and the dwZBufferOpCode field
  2094.  * in the DDBLTFX structure as the z-buffer and z-buffer opcode respectively
  2095.  * for the source.
  2096.  */
  2097. #define DDBLT_ZBUFFERSRCCONSTOVERRIDE           0x00400000l
  2098.  
  2099. /*
  2100.  * Z-buffered blt using the lpDDSSrcZBuffer field and the dwZBufferOpCode
  2101.  * field in the DDBLTFX structure as the z-buffer and z-buffer opcode
  2102.  * respectively for the source.
  2103.  */
  2104. #define DDBLT_ZBUFFERSRCOVERRIDE                0x00800000l
  2105.  
  2106. /*
  2107.  * wait until the device is ready to handle the blt
  2108.  * this will cause blt to not return DDERR_WASSTILLDRAWING
  2109.  */
  2110. #define DDBLT_WAIT                              0x01000000l
  2111.  
  2112. /*
  2113.  * Uses the dwFillDepth field in the DDBLTFX structure as the depth value
  2114.  * to fill the destination rectangle on the destination Z-buffer surface
  2115.  * with.
  2116.  */
  2117. #define DDBLT_DEPTHFILL                         0x02000000l
  2118.  
  2119.  
  2120. /****************************************************************************
  2121.  *
  2122.  * BLTFAST FLAGS
  2123.  *
  2124.  ****************************************************************************/
  2125.  
  2126. #define DDBLTFAST_NOCOLORKEY                    0x00000000
  2127. #define DDBLTFAST_SRCCOLORKEY                   0x00000001
  2128. #define DDBLTFAST_DESTCOLORKEY                  0x00000002
  2129. #define DDBLTFAST_WAIT                          0x00000010
  2130.  
  2131. /****************************************************************************
  2132.  *
  2133.  * FLIP FLAGS
  2134.  *
  2135.  ****************************************************************************/
  2136.  
  2137. #define DDFLIP_WAIT                          0x00000001l
  2138.  
  2139.  
  2140. /****************************************************************************
  2141.  *
  2142.  * DIRECTDRAW SURFACE OVERLAY FLAGS
  2143.  *
  2144.  ****************************************************************************/
  2145.  
  2146. /*
  2147.  * Use the alpha information in the pixel format or the alpha channel surface
  2148.  * attached to the destination surface as the alpha channel for the
  2149.  * destination overlay.
  2150.  */
  2151. #define DDOVER_ALPHADEST                        0x00000001l
  2152.  
  2153. /*
  2154.  * Use the dwConstAlphaDest field in the DDOVERLAYFX structure as the
  2155.  * destination alpha channel for this overlay.
  2156.  */
  2157. #define DDOVER_ALPHADESTCONSTOVERRIDE           0x00000002l
  2158.  
  2159. /*
  2160.  * The NEG suffix indicates that the destination surface becomes more
  2161.  * transparent as the alpha value increases. 
  2162.  */
  2163. #define DDOVER_ALPHADESTNEG                     0x00000004l
  2164.  
  2165. /*
  2166.  * Use the lpDDSAlphaDest field in the DDOVERLAYFX structure as the alpha
  2167.  * channel destination for this overlay.
  2168.  */
  2169. #define DDOVER_ALPHADESTSURFACEOVERRIDE         0x00000008l
  2170.  
  2171. /*
  2172.  * Use the dwAlphaEdgeBlend field in the DDOVERLAYFX structure as the alpha
  2173.  * channel for the edges of the image that border the color key colors.
  2174.  */
  2175. #define DDOVER_ALPHAEDGEBLEND                   0x00000010l
  2176.  
  2177. /*
  2178.  * Use the alpha information in the pixel format or the alpha channel surface
  2179.  * attached to the source surface as the source alpha channel for this overlay.
  2180.  */
  2181. #define DDOVER_ALPHASRC                         0x00000020l
  2182.  
  2183. /*
  2184.  * Use the dwConstAlphaSrc field in the DDOVERLAYFX structure as the source
  2185.  * alpha channel for this overlay.
  2186.  */
  2187. #define DDOVER_ALPHASRCCONSTOVERRIDE            0x00000040l
  2188.  
  2189. /*
  2190.  * The NEG suffix indicates that the source surface becomes more transparent
  2191.  * as the alpha value increases.
  2192.  */
  2193. #define DDOVER_ALPHASRCNEG                      0x00000080l
  2194.  
  2195. /*
  2196.  * Use the lpDDSAlphaSrc field in the DDOVERLAYFX structure as the alpha channel
  2197.  * source for this overlay.
  2198.  */
  2199. #define DDOVER_ALPHASRCSURFACEOVERRIDE          0x00000100l
  2200.  
  2201. /*
  2202.  * Turn this overlay off.
  2203.  */
  2204. #define DDOVER_HIDE                             0x00000200l
  2205.  
  2206. /*
  2207.  * Use the color key associated with the destination surface.
  2208.  */
  2209. #define DDOVER_KEYDEST                          0x00000400l
  2210.  
  2211. /*
  2212.  * Use the dckDestColorkey field in the DDOVERLAYFX structure as the color key
  2213.  * for the destination surface
  2214.  */
  2215. #define DDOVER_KEYDESTOVERRIDE                  0x00000800l
  2216.  
  2217. /*
  2218.  * Use the color key associated with the source surface.
  2219.  */
  2220. #define DDOVER_KEYSRC                           0x00001000l
  2221.  
  2222. /*
  2223.  * Use the dckSrcColorkey field in the DDOVERLAYFX structure as the color key
  2224.  * for the source surface.
  2225.  */
  2226. #define DDOVER_KEYSRCOVERRIDE                   0x00002000l
  2227.  
  2228. /*
  2229.  * Turn this overlay on.
  2230.  */
  2231. #define DDOVER_SHOW                             0x00004000l
  2232.  
  2233. /*
  2234.  * Add a dirty rect to an emulated overlayed surface.
  2235.  */
  2236. #define DDOVER_ADDDIRTYRECT                     0x00008000l
  2237.  
  2238. /*
  2239.  * Redraw all dirty rects on an emulated overlayed surface.
  2240.  */
  2241. #define DDOVER_REFRESHDIRTYRECTS                0x00010000l
  2242.  
  2243. /*
  2244.  * Redraw the entire surface on an emulated overlayed surface.
  2245.  */
  2246. #define DDOVER_REFRESHALL                      0x00020000l
  2247.  
  2248.  
  2249. /*
  2250.  * Use the overlay FX flags to define special overlay FX
  2251.  */
  2252. #define DDOVER_DDFX                             0x00080000l
  2253.  
  2254.  
  2255. /****************************************************************************
  2256.  *
  2257.  * DIRECTDRAWSURFACE LOCK FLAGS
  2258.  *
  2259.  ****************************************************************************/
  2260.  
  2261. /*
  2262.  * The default.  Set to indicate that Lock should return a valid memory pointer
  2263.  * to the top of the specified rectangle.  If no rectangle is specified then a
  2264.  * pointer to the top of the surface is returned.
  2265.  */
  2266. #define DDLOCK_SURFACEMEMORYPTR                 0x00000000L     // default
  2267.  
  2268. /*
  2269.  * Set to indicate that Lock should wait until it can obtain a valid memory
  2270.  * pointer before returning.  If this bit is set, Lock will never return 
  2271.  * DDERR_WASSTILLDRAWING.
  2272.  */
  2273. #define DDLOCK_WAIT                             0x00000001L
  2274.  
  2275. /*
  2276.  * Set if an event handle is being passed to Lock.  Lock will trigger the event
  2277.  * when it can return the surface memory pointer requested.
  2278.  */
  2279. #define DDLOCK_EVENT                            0x00000002L
  2280.  
  2281. /*
  2282.  * Indicates that the surface being locked will only be read from.
  2283.  */
  2284. #define DDLOCK_READONLY                         0x00000010L
  2285.  
  2286. /*
  2287.  * Indicates that the surface being locked will only be written to
  2288.  */
  2289. #define DDLOCK_WRITEONLY                        0x00000020L
  2290.  
  2291.  
  2292. /****************************************************************************
  2293.  *
  2294.  * DIRECTDRAWSURFACE PAGELOCK FLAGS
  2295.  *
  2296.  ****************************************************************************/
  2297.  
  2298. /*
  2299.  * No flags defined at present
  2300.  */
  2301.  
  2302.  
  2303. /****************************************************************************
  2304.  *
  2305.  * DIRECTDRAWSURFACE PAGEUNLOCK FLAGS
  2306.  *
  2307.  ****************************************************************************/
  2308.  
  2309. /*
  2310.  * No flags defined at present
  2311.  */
  2312.  
  2313.  
  2314. /****************************************************************************
  2315.  *
  2316.  * DIRECTDRAWSURFACE BLT FX FLAGS
  2317.  *
  2318.  ****************************************************************************/
  2319.  
  2320. /*
  2321.  * If stretching, use arithmetic stretching along the Y axis for this blt.
  2322.  */
  2323. #define DDBLTFX_ARITHSTRETCHY                   0x00000001l
  2324.  
  2325. /*
  2326.  * Do this blt mirroring the surface left to right.  Spin the
  2327.  * surface around its y-axis.
  2328.  */
  2329. #define DDBLTFX_MIRRORLEFTRIGHT                 0x00000002l
  2330.  
  2331. /*
  2332.  * Do this blt mirroring the surface up and down.  Spin the surface
  2333.  * around its x-axis.
  2334.  */
  2335. #define DDBLTFX_MIRRORUPDOWN                    0x00000004l
  2336.  
  2337. /*
  2338.  * Schedule this blt to avoid tearing.
  2339.  */
  2340. #define DDBLTFX_NOTEARING                       0x00000008l
  2341.  
  2342. /*
  2343.  * Do this blt rotating the surface one hundred and eighty degrees.
  2344.  */
  2345. #define DDBLTFX_ROTATE180                       0x00000010l
  2346.  
  2347. /*
  2348.  * Do this blt rotating the surface two hundred and seventy degrees.
  2349.  */
  2350. #define DDBLTFX_ROTATE270                       0x00000020l
  2351.  
  2352. /*
  2353.  * Do this blt rotating the surface ninety degrees.
  2354.  */
  2355. #define DDBLTFX_ROTATE90                        0x00000040l
  2356.  
  2357. /*
  2358.  * Do this z blt using dwZBufferLow and dwZBufferHigh as  range values
  2359.  * specified to limit the bits copied from the source surface.
  2360.  */
  2361. #define DDBLTFX_ZBUFFERRANGE                    0x00000080l
  2362.  
  2363. /*
  2364.  * Do this z blt adding the dwZBufferBaseDest to each of the sources z values
  2365.  * before comparing it with the desting z values.
  2366.  */
  2367. #define DDBLTFX_ZBUFFERBASEDEST                 0x00000100l
  2368.  
  2369. /****************************************************************************
  2370.  *
  2371.  * DIRECTDRAWSURFACE OVERLAY FX FLAGS
  2372.  *
  2373.  ****************************************************************************/
  2374.  
  2375. /*
  2376.  * If stretching, use arithmetic stretching along the Y axis for this overlay.
  2377.  */
  2378. #define DDOVERFX_ARITHSTRETCHY                  0x00000001l
  2379.  
  2380. /*
  2381.  * Mirror the overlay across the vertical axis
  2382.  */
  2383. #define DDOVERFX_MIRRORLEFTRIGHT                0x00000002l
  2384.  
  2385. /*
  2386.  * Mirror the overlay across the horizontal axis
  2387.  */
  2388. #define DDOVERFX_MIRRORUPDOWN                   0x00000004l
  2389.  
  2390. /****************************************************************************
  2391.  *
  2392.  * DIRECTDRAW WAITFORVERTICALBLANK FLAGS
  2393.  *
  2394.  ****************************************************************************/
  2395.  
  2396. /*
  2397.  * return when the vertical blank interval begins
  2398.  */
  2399. #define DDWAITVB_BLOCKBEGIN                     0x00000001l
  2400.  
  2401. /*
  2402.  * set up an event to trigger when the vertical blank begins
  2403.  */
  2404. #define DDWAITVB_BLOCKBEGINEVENT                0x00000002l
  2405.  
  2406. /*
  2407.  * return when the vertical blank interval ends and display begins
  2408.  */
  2409. #define DDWAITVB_BLOCKEND                       0x00000004l
  2410.  
  2411. /****************************************************************************
  2412.  *
  2413.  * DIRECTDRAW GETFLIPSTATUS FLAGS
  2414.  *
  2415.  ****************************************************************************/
  2416.  
  2417. /*
  2418.  * is it OK to flip now?
  2419.  */
  2420. #define DDGFS_CANFLIP                   0x00000001l
  2421.  
  2422. /*
  2423.  * is the last flip finished?
  2424.  */
  2425. #define DDGFS_ISFLIPDONE                0x00000002l
  2426.  
  2427. /****************************************************************************
  2428.  *
  2429.  * DIRECTDRAW GETBLTSTATUS FLAGS
  2430.  *
  2431.  ****************************************************************************/
  2432.  
  2433. /*
  2434.  * is it OK to blt now?
  2435.  */
  2436. #define DDGBS_CANBLT                    0x00000001l
  2437.  
  2438. /*
  2439.  * is the blt to the surface finished?
  2440.  */
  2441. #define DDGBS_ISBLTDONE                 0x00000002l
  2442.  
  2443.  
  2444. /****************************************************************************
  2445.  *
  2446.  * DIRECTDRAW ENUMOVERLAYZORDER FLAGS
  2447.  *
  2448.  ****************************************************************************/
  2449.  
  2450. /*
  2451.  * Enumerate overlays back to front.
  2452.  */
  2453. #define DDENUMOVERLAYZ_BACKTOFRONT      0x00000000l
  2454.  
  2455. /*
  2456.  * Enumerate overlays front to back
  2457.  */
  2458. #define DDENUMOVERLAYZ_FRONTTOBACK      0x00000001l
  2459.  
  2460. /****************************************************************************
  2461.  *
  2462.  * DIRECTDRAW UPDATEOVERLAYZORDER FLAGS
  2463.  *
  2464.  ****************************************************************************/
  2465.  
  2466. /*
  2467.  * Send overlay to front
  2468.  */
  2469. #define DDOVERZ_SENDTOFRONT             0x00000000l
  2470.  
  2471. /*
  2472.  * Send overlay to back
  2473.  */
  2474. #define DDOVERZ_SENDTOBACK              0x00000001l
  2475.  
  2476. /*
  2477.  * Move Overlay forward
  2478.  */
  2479. #define DDOVERZ_MOVEFORWARD             0x00000002l
  2480.  
  2481. /*
  2482.  * Move Overlay backward
  2483.  */
  2484. #define DDOVERZ_MOVEBACKWARD            0x00000003l
  2485.  
  2486. /*
  2487.  * Move Overlay in front of relative surface
  2488.  */
  2489. #define DDOVERZ_INSERTINFRONTOF         0x00000004l
  2490.  
  2491. /*
  2492.  * Move Overlay in back of relative surface
  2493.  */
  2494. #define DDOVERZ_INSERTINBACKOF          0x00000005l
  2495.  
  2496. /*===========================================================================
  2497.  *
  2498.  *
  2499.  * DIRECTDRAW RETURN CODES
  2500.  *
  2501.  * The return values from DirectDraw Commands and Surface that return an HRESULT
  2502.  * are codes from DirectDraw concerning the results of the action
  2503.  * requested by DirectDraw.
  2504.  *
  2505.  *==========================================================================*/
  2506.  
  2507. /*
  2508.  * Status is OK
  2509.  *
  2510.  * Issued by: DirectDraw Commands and all callbacks
  2511.  */
  2512. #define DD_OK                                   0
  2513.  
  2514. /****************************************************************************
  2515.  *
  2516.  * DIRECTDRAW ENUMCALLBACK RETURN VALUES
  2517.  *
  2518.  * EnumCallback returns are used to control the flow of the DIRECTDRAW and
  2519.  * DIRECTDRAWSURFACE object enumerations.   They can only be returned by
  2520.  * enumeration callback routines.
  2521.  *
  2522.  ****************************************************************************/
  2523.  
  2524. /*
  2525.  * stop the enumeration
  2526.  */
  2527. #define DDENUMRET_CANCEL                        0
  2528.  
  2529. /*
  2530.  * continue the enumeration
  2531.  */
  2532. #define DDENUMRET_OK                            1
  2533.  
  2534. /****************************************************************************
  2535.  *
  2536.  * DIRECTDRAW ERRORS
  2537.  *
  2538.  * Errors are represented by negative values and cannot be combined.
  2539.  *
  2540.  ****************************************************************************/
  2541.  
  2542. /*
  2543.  * This object is already initialized
  2544.  */
  2545. #define DDERR_ALREADYINITIALIZED                MAKE_DDHRESULT( 5 )
  2546.  
  2547. /*
  2548.  * This surface can not be attached to the requested surface.
  2549.  */
  2550. #define DDERR_CANNOTATTACHSURFACE               MAKE_DDHRESULT( 10 )
  2551.  
  2552. /*
  2553.  * This surface can not be detached from the requested surface.
  2554.  */
  2555. #define DDERR_CANNOTDETACHSURFACE               MAKE_DDHRESULT( 20 )
  2556.  
  2557. /*
  2558.  * Support is currently not available.
  2559.  */
  2560. #define DDERR_CURRENTLYNOTAVAIL                 MAKE_DDHRESULT( 40 )
  2561.  
  2562. /*
  2563.  * An exception was encountered while performing the requested operation
  2564.  */
  2565. #define DDERR_EXCEPTION                         MAKE_DDHRESULT( 55 )
  2566.  
  2567. /*
  2568.  * Generic failure.
  2569.  */
  2570. #define DDERR_GENERIC                           E_FAIL
  2571.  
  2572. /*
  2573.  * Height of rectangle provided is not a multiple of reqd alignment
  2574.  */
  2575. #define DDERR_HEIGHTALIGN                       MAKE_DDHRESULT( 90 )
  2576.  
  2577. /*
  2578.  * Unable to match primary surface creation request with existing 
  2579.  * primary surface.
  2580.  */
  2581. #define DDERR_INCOMPATIBLEPRIMARY               MAKE_DDHRESULT( 95 )
  2582.  
  2583. /*
  2584.  * One or more of the caps bits passed to the callback are incorrect.
  2585.  */
  2586. #define DDERR_INVALIDCAPS                       MAKE_DDHRESULT( 100 )
  2587.  
  2588. /*
  2589.  * DirectDraw does not support provided Cliplist.
  2590.  */
  2591. #define DDERR_INVALIDCLIPLIST                   MAKE_DDHRESULT( 110 )
  2592.  
  2593. /*
  2594.  * DirectDraw does not support the requested mode
  2595.  */
  2596. #define DDERR_INVALIDMODE                       MAKE_DDHRESULT( 120 )
  2597.  
  2598. /*
  2599.  * DirectDraw received a pointer that was an invalid DIRECTDRAW object.
  2600.  */
  2601. #define DDERR_INVALIDOBJECT                     MAKE_DDHRESULT( 130 )
  2602.  
  2603. /*
  2604.  * One or more of the parameters passed to the callback function are
  2605.  * incorrect.
  2606.  */
  2607. #define DDERR_INVALIDPARAMS                     E_INVALIDARG
  2608.  
  2609. /*
  2610.  * pixel format was invalid as specified
  2611.  */
  2612. #define DDERR_INVALIDPIXELFORMAT                MAKE_DDHRESULT( 145 )
  2613.  
  2614. /*
  2615.  * Rectangle provided was invalid.
  2616.  */
  2617. #define DDERR_INVALIDRECT                       MAKE_DDHRESULT( 150 )
  2618.  
  2619. /*
  2620.  * Operation could not be carried out because one or more surfaces are locked
  2621.  */
  2622. #define DDERR_LOCKEDSURFACES                    MAKE_DDHRESULT( 160 )
  2623.  
  2624. /*
  2625.  * There is no 3D present.
  2626.  */
  2627. #define DDERR_NO3D                              MAKE_DDHRESULT( 170 )
  2628.  
  2629. /*
  2630.  * Operation could not be carried out because there is no alpha accleration
  2631.  * hardware present or available.
  2632.  */
  2633. #define DDERR_NOALPHAHW                         MAKE_DDHRESULT( 180 )
  2634.  
  2635.  
  2636. /*
  2637.  * no clip list available
  2638.  */
  2639. #define DDERR_NOCLIPLIST                        MAKE_DDHRESULT( 205 )
  2640.  
  2641. /*
  2642.  * Operation could not be carried out because there is no color conversion
  2643.  * hardware present or available.
  2644.  */
  2645. #define DDERR_NOCOLORCONVHW                     MAKE_DDHRESULT( 210 )
  2646.  
  2647. /*
  2648.  * Create function called without DirectDraw object method SetCooperativeLevel
  2649.  * being called.
  2650.  */
  2651. #define DDERR_NOCOOPERATIVELEVELSET             MAKE_DDHRESULT( 212 )
  2652.  
  2653. /*
  2654.  * Surface doesn't currently have a color key
  2655.  */
  2656. #define DDERR_NOCOLORKEY                        MAKE_DDHRESULT( 215 )
  2657.  
  2658. /*
  2659.  * Operation could not be carried out because there is no hardware support
  2660.  * of the dest color key.
  2661.  */
  2662. #define DDERR_NOCOLORKEYHW                      MAKE_DDHRESULT( 220 )
  2663.  
  2664. /*
  2665.  * No DirectDraw support possible with current display driver
  2666.  */
  2667. #define DDERR_NODIRECTDRAWSUPPORT               MAKE_DDHRESULT( 222 )
  2668.  
  2669. /*
  2670.  * Operation requires the application to have exclusive mode but the
  2671.  * application does not have exclusive mode.
  2672.  */
  2673. #define DDERR_NOEXCLUSIVEMODE                   MAKE_DDHRESULT( 225 )
  2674.  
  2675. /*
  2676.  * Flipping visible surfaces is not supported.
  2677.  */
  2678. #define DDERR_NOFLIPHW                          MAKE_DDHRESULT( 230 )
  2679.  
  2680. /*
  2681.  * There is no GDI present.
  2682.  */
  2683. #define DDERR_NOGDI                             MAKE_DDHRESULT( 240 )
  2684.  
  2685. /*
  2686.  * Operation could not be carried out because there is no hardware present
  2687.  * or available.
  2688.  */
  2689. #define DDERR_NOMIRRORHW                        MAKE_DDHRESULT( 250 )
  2690.  
  2691. /*
  2692.  * Requested item was not found
  2693.  */
  2694. #define DDERR_NOTFOUND                          MAKE_DDHRESULT( 255 )
  2695.  
  2696. /*
  2697.  * Operation could not be carried out because there is no overlay hardware
  2698.  * present or available.
  2699.  */
  2700. #define DDERR_NOOVERLAYHW                       MAKE_DDHRESULT( 260 )
  2701.  
  2702. /*
  2703.  * Operation could not be carried out because there is no appropriate raster
  2704.  * op hardware present or available.
  2705.  */
  2706. #define DDERR_NORASTEROPHW                      MAKE_DDHRESULT( 280 )
  2707.  
  2708. /*
  2709.  * Operation could not be carried out because there is no rotation hardware
  2710.  * present or available.
  2711.  */
  2712. #define DDERR_NOROTATIONHW                      MAKE_DDHRESULT( 290 )
  2713.  
  2714. /*
  2715.  * Operation could not be carried out because there is no hardware support
  2716.  * for stretching
  2717.  */
  2718. #define DDERR_NOSTRETCHHW                       MAKE_DDHRESULT( 310 )
  2719.  
  2720. /*
  2721.  * DirectDrawSurface is not in 4 bit color palette and the requested operation
  2722.  * requires 4 bit color palette.
  2723.  */
  2724. #define DDERR_NOT4BITCOLOR                      MAKE_DDHRESULT( 316 )
  2725.  
  2726. /*
  2727.  * DirectDrawSurface is not in 4 bit color index palette and the requested
  2728.  * operation requires 4 bit color index palette.
  2729.  */
  2730. #define DDERR_NOT4BITCOLORINDEX                 MAKE_DDHRESULT( 317 )
  2731.  
  2732. /*
  2733.  * DirectDraw Surface is not in 8 bit color mode and the requested operation
  2734.  * requires 8 bit color.
  2735.  */
  2736. #define DDERR_NOT8BITCOLOR                      MAKE_DDHRESULT( 320 )
  2737.  
  2738. /*
  2739.  * Operation could not be carried out because there is no texture mapping
  2740.  * hardware present or available.
  2741.  */
  2742. #define DDERR_NOTEXTUREHW                       MAKE_DDHRESULT( 330 )
  2743.  
  2744. /*
  2745.  * Operation could not be carried out because there is no hardware support
  2746.  * for vertical blank synchronized operations.
  2747.  */
  2748. #define DDERR_NOVSYNCHW                         MAKE_DDHRESULT( 335 )
  2749.  
  2750. /*
  2751.  * Operation could not be carried out because there is no hardware support
  2752.  * for zbuffer blting.
  2753.  */
  2754. #define DDERR_NOZBUFFERHW                       MAKE_DDHRESULT( 340 )
  2755.  
  2756. /*
  2757.  * Overlay surfaces could not be z layered based on their BltOrder because
  2758.  * the hardware does not support z layering of overlays.
  2759.  */
  2760. #define DDERR_NOZOVERLAYHW                      MAKE_DDHRESULT( 350 )
  2761.  
  2762. /*
  2763.  * The hardware needed for the requested operation has already been
  2764.  * allocated.
  2765.  */
  2766. #define DDERR_OUTOFCAPS                         MAKE_DDHRESULT( 360 )
  2767.  
  2768. /*
  2769.  * DirectDraw does not have enough memory to perform the operation.
  2770.  */
  2771. #define DDERR_OUTOFMEMORY                       E_OUTOFMEMORY
  2772.  
  2773. /*
  2774.  * DirectDraw does not have enough memory to perform the operation.
  2775.  */
  2776. #define DDERR_OUTOFVIDEOMEMORY                  MAKE_DDHRESULT( 380 )
  2777.  
  2778. /*
  2779.  * hardware does not support clipped overlays
  2780.  */
  2781. #define DDERR_OVERLAYCANTCLIP                   MAKE_DDHRESULT( 382 )
  2782.  
  2783. /*
  2784.  * Can only have ony color key active at one time for overlays
  2785.  */
  2786. #define DDERR_OVERLAYCOLORKEYONLYONEACTIVE      MAKE_DDHRESULT( 384 )
  2787.  
  2788. /*
  2789.  * Access to this palette is being refused because the palette is already
  2790.  * locked by another thread.
  2791.  */
  2792. #define DDERR_PALETTEBUSY                       MAKE_DDHRESULT( 387 )
  2793.  
  2794. /*
  2795.  * No src color key specified for this operation.
  2796.  */
  2797. #define DDERR_COLORKEYNOTSET                    MAKE_DDHRESULT( 400 )
  2798.  
  2799. /*
  2800.  * This surface is already attached to the surface it is being attached to.
  2801.  */
  2802. #define DDERR_SURFACEALREADYATTACHED            MAKE_DDHRESULT( 410 )
  2803.  
  2804. /*
  2805.  * This surface is already a dependency of the surface it is being made a
  2806.  * dependency of.
  2807.  */
  2808. #define DDERR_SURFACEALREADYDEPENDENT           MAKE_DDHRESULT( 420 )
  2809.  
  2810. /*
  2811.  * Access to this surface is being refused because the surface is already
  2812.  * locked by another thread.
  2813.  */
  2814. #define DDERR_SURFACEBUSY                       MAKE_DDHRESULT( 430 )
  2815.  
  2816. /*
  2817.  * Access to this surface is being refused because no driver exists
  2818.  * which can supply a pointer to the surface.
  2819.  * This is most likely to happen when attempting to lock the primary
  2820.  * surface when no DCI provider is present.
  2821.  */
  2822. #define DDERR_CANTLOCKSURFACE                   MAKE_DDHRESULT( 435 )
  2823.  
  2824. /*
  2825.  * Access to Surface refused because Surface is obscured.
  2826.  */
  2827. #define DDERR_SURFACEISOBSCURED                 MAKE_DDHRESULT( 440 )
  2828.  
  2829. /*
  2830.  * Access to this surface is being refused because the surface is gone.
  2831.  * The DIRECTDRAWSURFACE object representing this surface should 
  2832.  * have Restore called on it.
  2833.  */
  2834. #define DDERR_SURFACELOST                       MAKE_DDHRESULT( 450 )
  2835.  
  2836. /*
  2837.  * The requested surface is not attached.
  2838.  */
  2839. #define DDERR_SURFACENOTATTACHED                MAKE_DDHRESULT( 460 )
  2840.  
  2841. /*
  2842.  * Height requested by DirectDraw is too large.
  2843.  */
  2844. #define DDERR_TOOBIGHEIGHT                      MAKE_DDHRESULT( 470 )
  2845.  
  2846. /*
  2847.  * Size requested by DirectDraw is too large --  The individual height and
  2848.  * width are OK.
  2849.  */
  2850. #define DDERR_TOOBIGSIZE                        MAKE_DDHRESULT( 480 )
  2851.  
  2852. /*
  2853.  * Width requested by DirectDraw is too large.
  2854.  */
  2855. #define DDERR_TOOBIGWIDTH                       MAKE_DDHRESULT( 490 )
  2856.  
  2857. /*
  2858.  * Action not supported.
  2859.  */
  2860. #define DDERR_UNSUPPORTED                       E_NOTIMPL
  2861.  
  2862. /*
  2863.  * FOURCC format requested is unsupported by DirectDraw
  2864.  */
  2865. #define DDERR_UNSUPPORTEDFORMAT                 MAKE_DDHRESULT( 510 )
  2866.  
  2867. /*
  2868.  * Bitmask in the pixel format requested is unsupported by DirectDraw
  2869.  */
  2870. #define DDERR_UNSUPPORTEDMASK                   MAKE_DDHRESULT( 520 )
  2871.  
  2872. /*
  2873.  * vertical blank is in progress
  2874.  */
  2875. #define DDERR_VERTICALBLANKINPROGRESS           MAKE_DDHRESULT( 537 )
  2876.  
  2877. /*
  2878.  * Informs DirectDraw that the previous Blt which is transfering information
  2879.  * to or from this Surface is incomplete.
  2880.  */
  2881. #define DDERR_WASSTILLDRAWING                   MAKE_DDHRESULT( 540 )
  2882.  
  2883. /*
  2884.  * Rectangle provided was not horizontally aligned on reqd. boundary
  2885.  */
  2886. #define DDERR_XALIGN                            MAKE_DDHRESULT( 560 )
  2887.  
  2888. /*
  2889.  * The GUID passed to DirectDrawCreate is not a valid DirectDraw driver
  2890.  * identifier.
  2891.  */
  2892. #define DDERR_INVALIDDIRECTDRAWGUID             MAKE_DDHRESULT( 561 )
  2893.  
  2894. /*
  2895.  * A DirectDraw object representing this driver has already been created
  2896.  * for this process.
  2897.  */
  2898. #define DDERR_DIRECTDRAWALREADYCREATED          MAKE_DDHRESULT( 562 )
  2899.  
  2900. /*
  2901.  * A hardware only DirectDraw object creation was attempted but the driver
  2902.  * did not support any hardware.
  2903.  */
  2904. #define DDERR_NODIRECTDRAWHW                    MAKE_DDHRESULT( 563 )
  2905.  
  2906. /*
  2907.  * this process already has created a primary surface
  2908.  */
  2909. #define DDERR_PRIMARYSURFACEALREADYEXISTS       MAKE_DDHRESULT( 564 )
  2910.  
  2911. /*
  2912.  * software emulation not available.
  2913.  */
  2914. #define DDERR_NOEMULATION                       MAKE_DDHRESULT( 565 )
  2915.  
  2916. /*
  2917.  * region passed to Clipper::GetClipList is too small.
  2918.  */
  2919. #define DDERR_REGIONTOOSMALL                    MAKE_DDHRESULT( 566 )
  2920.  
  2921. /*
  2922.  * an attempt was made to set a clip list for a clipper objec that
  2923.  * is already monitoring an hwnd.
  2924.  */
  2925. #define DDERR_CLIPPERISUSINGHWND                MAKE_DDHRESULT( 567 )
  2926.  
  2927. /*
  2928.  * No clipper object attached to surface object
  2929.  */
  2930. #define DDERR_NOCLIPPERATTACHED                 MAKE_DDHRESULT( 568 )
  2931.  
  2932. /*
  2933.  * Clipper notification requires an HWND or
  2934.  * no HWND has previously been set as the CooperativeLevel HWND.
  2935.  */
  2936. #define DDERR_NOHWND                            MAKE_DDHRESULT( 569 )
  2937.  
  2938. /*
  2939.  * HWND used by DirectDraw CooperativeLevel has been subclassed,
  2940.  * this prevents DirectDraw from restoring state.
  2941.  */
  2942. #define DDERR_HWNDSUBCLASSED                    MAKE_DDHRESULT( 570 )
  2943.  
  2944. /*
  2945.  * The CooperativeLevel HWND has already been set.
  2946.  * It can not be reset while the process has surfaces or palettes created.
  2947.  */
  2948. #define DDERR_HWNDALREADYSET                    MAKE_DDHRESULT( 571 )
  2949.  
  2950. /*
  2951.  * No palette object attached to this surface.
  2952.  */
  2953. #define DDERR_NOPALETTEATTACHED                 MAKE_DDHRESULT( 572 )
  2954.  
  2955. /*
  2956.  * No hardware support for 16 or 256 color palettes.
  2957.  */
  2958. #define DDERR_NOPALETTEHW                       MAKE_DDHRESULT( 573 )
  2959.  
  2960. /*
  2961.  * If a clipper object is attached to the source surface passed into a
  2962.  * BltFast call.
  2963.  */
  2964. #define DDERR_BLTFASTCANTCLIP                   MAKE_DDHRESULT( 574 )
  2965.  
  2966. /*
  2967.  * No blter.
  2968.  */
  2969. #define DDERR_NOBLTHW                           MAKE_DDHRESULT( 575 )
  2970.  
  2971. /*
  2972.  * No DirectDraw ROP hardware.
  2973.  */
  2974. #define DDERR_NODDROPSHW                        MAKE_DDHRESULT( 576 )
  2975.  
  2976. /*
  2977.  * returned when GetOverlayPosition is called on a hidden overlay
  2978.  */
  2979. #define DDERR_OVERLAYNOTVISIBLE                 MAKE_DDHRESULT( 577 )
  2980.  
  2981. /*
  2982.  * returned when GetOverlayPosition is called on a overlay that UpdateOverlay
  2983.  * has never been called on to establish a destionation.
  2984.  */
  2985. #define DDERR_NOOVERLAYDEST                     MAKE_DDHRESULT( 578 )
  2986.  
  2987. /*
  2988.  * returned when the position of the overlay on the destionation is no longer
  2989.  * legal for that destionation.
  2990.  */
  2991. #define DDERR_INVALIDPOSITION                   MAKE_DDHRESULT( 579 )
  2992.  
  2993. /*
  2994.  * returned when an overlay member is called for a non-overlay surface
  2995.  */
  2996. #define DDERR_NOTAOVERLAYSURFACE                MAKE_DDHRESULT( 580 )
  2997.  
  2998. /*
  2999.  * An attempt was made to set the cooperative level when it was already
  3000.  * set to exclusive.
  3001.  */
  3002. #define DDERR_EXCLUSIVEMODEALREADYSET           MAKE_DDHRESULT( 581 )
  3003.  
  3004. /*
  3005.  * An attempt has been made to flip a surface that is not flippable.
  3006.  */
  3007. #define DDERR_NOTFLIPPABLE                      MAKE_DDHRESULT( 582 )
  3008.  
  3009. /*
  3010.  * Can't duplicate primary & 3D surfaces, or surfaces that are implicitly
  3011.  * created.
  3012.  */
  3013. #define DDERR_CANTDUPLICATE                     MAKE_DDHRESULT( 583 )
  3014.  
  3015. /*
  3016.  * Surface was not locked.  An attempt to unlock a surface that was not
  3017.  * locked at all, or by this process, has been attempted.
  3018.  */
  3019. #define DDERR_NOTLOCKED                         MAKE_DDHRESULT( 584 )
  3020.  
  3021. /*
  3022.  * Windows can not create any more DCs
  3023.  */
  3024. #define DDERR_CANTCREATEDC                      MAKE_DDHRESULT( 585 )
  3025.  
  3026. /*
  3027.  * No DC was ever created for this surface.
  3028.  */
  3029. #define DDERR_NODC                              MAKE_DDHRESULT( 586 )
  3030.  
  3031. /*
  3032.  * This surface can not be restored because it was created in a different
  3033.  * mode.
  3034.  */
  3035. #define DDERR_WRONGMODE                         MAKE_DDHRESULT( 587 )
  3036.  
  3037. /*
  3038.  * This surface can not be restored because it is an implicitly created
  3039.  * surface.
  3040.  */
  3041. #define DDERR_IMPLICITLYCREATED                 MAKE_DDHRESULT( 588 )
  3042.  
  3043. /*
  3044.  * The surface being used is not a palette-based surface
  3045.  */
  3046. #define DDERR_NOTPALETTIZED                     MAKE_DDHRESULT( 589 )
  3047.  
  3048.  
  3049. /*
  3050.  * The display is currently in an unsupported mode
  3051.  */
  3052. #define DDERR_UNSUPPORTEDMODE                   MAKE_DDHRESULT( 590 )
  3053.  
  3054. /*
  3055.  * Operation could not be carried out because there is no mip-map
  3056.  * texture mapping hardware present or available.
  3057.  */
  3058. #define DDERR_NOMIPMAPHW                        MAKE_DDHRESULT( 591 )
  3059.  
  3060. /*
  3061.  * The requested action could not be performed because the surface was of
  3062.  * the wrong type.
  3063.  */
  3064. #define DDERR_INVALIDSURFACETYPE                MAKE_DDHRESULT( 592 )
  3065.  
  3066.  
  3067.  
  3068. /*
  3069.  * A DC has already been returned for this surface. Only one DC can be 
  3070.  * retrieved per surface.
  3071.  */
  3072. #define DDERR_DCALREADYCREATED                  MAKE_DDHRESULT( 620 )
  3073.  
  3074. /*
  3075.  * The attempt to page lock a surface failed.
  3076.  */
  3077. #define DDERR_CANTPAGELOCK                      MAKE_DDHRESULT( 640 )
  3078.  
  3079. /*
  3080.  * The attempt to page unlock a surface failed.
  3081.  */
  3082. #define DDERR_CANTPAGEUNLOCK                    MAKE_DDHRESULT( 660 )
  3083.  
  3084. /*
  3085.  * An attempt was made to page unlock a surface with no outstanding page locks.
  3086.  */
  3087. #define DDERR_NOTPAGELOCKED                     MAKE_DDHRESULT( 680 )
  3088.  
  3089. /*
  3090.  * An attempt was made to invoke an interface member of a DirectDraw object
  3091.  * created by CoCreateInstance() before it was initialized.
  3092.  */
  3093. #define DDERR_NOTINITIALIZED                    CO_E_NOTINITIALIZED
  3094.  
  3095. /* Alpha bit depth constants */
  3096.  
  3097.  
  3098. #ifdef __cplusplus
  3099. };
  3100. #endif
  3101.  
  3102. #endif
  3103.